新しい「つぶやく」場所を作成します geo place
2012年のTwitter APIの記事です。
参考資料として掲載しておきます。
目次 [閉じる]
Twitter API geo/place
API Resource
GET geo/place
概要
新しい「つぶやく」場所を作成します。
作成するには、パラメーターの経度、緯度、名前、トークン(geo/similar_placesで取得)を指定します。
新しい場所を作成する前に、 geo/similar_places で予定している場所情報の経度、緯度、名前をこのメソッドで指定して類似情報を確認します。
類似情報がない場合に、geo/similar_places で取得したトークンを使用して新しい場所を作成します。
原文
Resource URL(リソースURL)
http://api.twitter.com/1/geo/place.json
Resource Information(リソース情報)
Rate Limited(制限) | Yes(あり) |
Requires Authentication(認証) | Yes(あり) |
Response Formats(フォーマット) | json |
HTTP Methods(HTTPメソッド) | POST |
Parameters(パラメーター)
次のパラメーター lat,long,ip,query これらの少なくとも一つは指定する必要があります。
name ※必須 | サンプル値:Twitter%20HQ | 既知の場所の名前を指定します。 |
contained_within ※必須 | サンプル値:247f43d441defc03 | 検索範囲を place_id で指定します。結果は place_id で指定したエリア内に限定されます。 例えば、「San Francisco, CA USA」を検索範囲にする場合は、place_id を 5a110d312052166f とします。 |
token ※必須 | サンプル値:36179c9bf78835898ebf521c1defd4be | geo/similar_places で取得した token を指定します。 |
lat ※必須 | サンプル値:37.7821120598956 | 新規作成地点の緯度を指定します。有効範囲は北緯が+90.0まで、南緯は-90.0まで、小数点以下8桁まで指定可能です。 有効範囲外の値を指定した場合やlongパラメータが指定されていない場合は無効になります。 |
long ※必須 | サンプル値:-122.400612831116 | 新規作成地点の軽度を指定します。有効範囲は東経が+180.0まで、西経は-180.0まで、小数点以下8桁まで指定可能です。 有効範囲外の値を指定した場合やlatパラメータが指定されていない場合は無効になります。 |
attribute:street_address ※オプション | サンプル値:795%20Folsom%20St | 住所検索を行う場合にこのパラメーターを指定します。 |
callback ※オプション | サンプル値:name | このパラメーターを指定した場合、指定された名前のcallbackをJSONP形式で返します。 |
サンプルコード
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja"> <head> <meta name="robots" content="index"> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Twitter API geo place 新しい「つぶやく」場所を作成します。</title> </head> <body> <?php ######################################### ### 初期設定 //twitteroauth.phpをインクルードします。ファイルへのパスは環境に合わせて記述下さい。 require_once("./twitteroauth.php"); //Consumer keyの値をTwitterAPI開発者ページでご確認下さい。 $consumerKey = "***************"; //Consumer secretの値を格納 $consumerSecret = "***********************************"; //Access Tokenの値を格納 $accessToken = "***********************************"; //Access Token Secretの値を格納 $accessTokenSecret = "***********************************"; //OAuthオブジェクトを生成する $twObj = new TwitterOAuth($consumerKey,$consumerSecret,$accessToken,$accessTokenSecret); ?> <?php ######################################### ### ページ説明 ?> <h1>Twitter API geo place 新しい「つぶやく」場所を作成します。</h1> <!-- 説明ページurl --> <h3><a href="https://wepicks.net/2012/02/02/phpapptwitter-geo_place/">→説明はこちら</a></h3> <hr/> <?php ######################################### ### 取得したデータを展開 ?> <h2>取得したデータを展開</h2> <div style="background-color:#f8f8f8;margin:20px; padding:20px; border:solid #cccccc 1px;"> <!-- // =========================== ここから =========================== --> <?php //API実行データ取得 //東京 'lat' => '35.6894875', 'long' => '139.6917064' $sName = urlencode('東京タワー'); $vRequest = $twObj->OAuthRequest("http://api.twitter.com/1/geo/place.json","POST", array ( 'name' => $sName, 'contained_within' => 'a56612250c754f23', 'lat' => '35.658586409153', 'long' => '139.7455573082', 'token' => 'a37c519c76570ace8abfc4064fe543e7' ) ); //Jsonデータをオブジェクトに変更 $oObj = json_decode($vRequest); //オブジェクトを展開 if(isset($oObj->{'error'}) && $oObj->{'error'} != ''){ echo "作成に失敗しました。<br>\n"; echo "パラメーターの指定を確認して下さい。<br>\n"; echo "エラーメッセージ:".$oObj->{'error'}."<br>\n"; }elseif(isset($oObj->{'errors'}) && $oObj->{'errors'} != ''){ echo "作成に失敗しました。<br>\n"; echo "パラメーターの指定を確認して下さい。<br>\n"; echo "エラーメッセージ:".$oObj->{'errors'}[0]->{'message'}."<br>\n"; }else{ echo "<h3>新しい「つぶやく」場所を作成しました。</h3>\n"; }//end else ?> <!-- =========================== ここまで =========================== // --> </div> <hr/> <?php ######################################### ### 取得したオブジェクトの内容 ?> <h2>取得したオブジェクトの内容</h2> <?php var_dump($oObj); ?> <hr/> </body> </html> |
タグ(=記事関連ワード)
タグ: Places & Geo, Twitter, twitter api
日付
投稿日:2012年2月2日
最終更新日:2023年08月25日
最終更新日:2023年08月25日
このカテゴリの他のページ
この記事へのコメント
トラックバックurl
https://wepicks.net/phpapptwitter-geo_place/trackback/