以上で完了です。

開発を始めるには、デベロッパー ドキュメント をご覧下さい。

Google Places API Web Service をアクティベートする

まず初めに Google Developers Console で次の作業を行います。

  1. プロジェクトを作成または選択する
  2. Google Places API Web Service をアクティベートする
  3. 適切なキーを作成する
続ける

プレイス検索

Google Places API Web Service を使用することで、施設、有名なスポット、地域など、さまざまなカテゴリにわたる場所情報を検索できるようになります。プレイスは距離的な近さまたはテキスト文字列を基準に検索できます。プレイスを検索すると、プレイスのリストや各プレイスの概要情報が結果として返されます。その他の情報は、プレイス詳細クエリで入手できます。

周辺検索リクエスト

これまでのバージョンの Places API では、周辺検索をプレイス検索と呼んでいました。

周辺検索では、範囲を指定してプレイスを検索できます。キーワードを指定したり、検索するプレイスのタイプを指定したりすることで、検索リクエストを絞り込むことができます。

周辺検索リクエストは、次の形式の HTTP URL です。

https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters

output には次のいずれかの値を設定します。

  • json(推奨)は、出力が JSON(JavaScript Object Notation)であることを示します。
  • xml は、出力が XML であることを示します。

周辺検索リクエストを開始するには、必須のパラメータがいくつかあります。URL の標準と同様に、パラメータはすべてアンパサンド(&)文字を使用して区切ります。

必須パラメータ

  • key: アプリケーションの API キーです。このキーを使って各アプリケーションを識別し、割り当て量を管理します。アプリケーションから追加したプレイスは、そのアプリケーションですぐに利用できるようになります。詳細については、キーの取得をご覧ください。
  • location: プレイス情報を取得する位置の緯度と経度を示します。緯度経度 の形式で指定してください。
  • radius: 検索の結果を返す場所の範囲(メートル単位)を示します。指定可能な最大半径は 50,000 メートルです。rankby=distance(下記の省略可能なパラメータをご覧ください)を使用する場合は、radius を指定できません。
  • rankby=distance(下記の省略可能なパラメータをご覧ください)を使用する場合は、keywordnametypes の 1 つ以上が必要になります。

省略可能なパラメータ

  • keyword: このプレイスに対し Google がインデックスに登録したすべてのコンテンツと突き合わせるキーワードです。名前、タイプ、住所をはじめとして、ユーザーのクチコミや第三者のコンテンツも対象になります。
  • language: 検索結果を返すときに使用する言語を示す言語コードです(指定できる場合)。また、検索では選択された言語が優先されます。選択された言語での結果は、より上位に表示されます。サポートされる言語とそのコードのリストをご覧ください。サポートされる言語は頻繁に更新されるため、このリストがすべてのサポート言語を網羅しているとは限りません。
  • minpricemaxprice省略可能): 指定した値の範囲内のプレイスに検索結果を限定します。有効な値の範囲は 0(最も安い)〜4(最も高い)です。それぞれの値が示す金額は地域によって異なります。
  • name: このプレイスに対して Google がインデックスに登録したすべてのコンテンツと突き合わせるキーワードです。keyword と同じです。name フィールドは、プレイス名に限定されなくなります。このフィールドの値は、keyword フィールドの値と組み合わされて、同じ検索文字列の一部として渡されます。すべての検索キーワードに keyword パラメータのみを使用することをお勧めします。
  • opennow: クエリが送信された時点で営業しているプレイスのみが返されます。クエリにこのパラメータを指定した場合、Google プレイスのデータベースに営業時間が登録されていないプレイスは返されません。
  • rankby: 検索結果を並べる順序を指定します。radius(上記の必須パラメータをご覧ください)を指定している場合、rankby は指定できません。有効な値は次のとおりです。
    • prominence(デフォルト)。このオプションを指定した場合は、プレイスの重要度で検索結果が並べられます。指定範囲内の知名度の高いプレイスが優先されてランキングされます。重要度は、Google のインデックスでのプレイスのランキングや、グローバルな人気度などの要因によって決まります。
    • distance。このオプションを指定した場合は、指定された location からの距離が近い順に検索結果が並べられます。distance を指定する場合、keywordnametypes のうちの 1 つ以上が必要です。
  • types: 指定したタイプと一致するプレイスに検索結果を限定します。指定できるタイプは 1 つだけです(複数のタイプを指定すると、最初のエントリの後に指定したタイプはすべて無視されます)。サポートされるタイプのリストをご覧ください。
  • typesサポート終了): 指定した 1 つ以上のタイプと一致するプレイスに検索結果を限定します。タイプはパイプ記号で区切ります(type1|type2|etc)。
  • pagetoken: 直前に実行した検索から次の 20 件の結果が返されます。pagetoken パラメータを設定すると、直前の検索と同じパラメータで検索が実行されます。pagetoken 以外のパラメータはすべて無視されます。
  • zagatselectedサポート終了): このパラメータを追加すると(関連値なしのパラメータ名のみ)、Zagat で選ばれたお店やサービスの場所のみに検索が限定されます。このパラメータに true 値や false 値は含められませんzagatselected パラメータは試験中のため、Premium Plan ライセンスを所有する Google Places API のユーザーのみご利用いただけます。

Google Maps APIs Premium Plan のユーザーへの注意事項:リクエストに API キーを含める必要があります。リクエストに client パラメータや signature パラメータを含めないでください

周辺検索の例

次の例は、オーストラリアのシドニーのある地点から半径 500 m 以内の、名前に「cruise」を含む「restaurant」タイプのプレイスの検索リクエストです。

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

注: アプリケーションでこのリクエストを実行する場合、この例の key を自分の API キーに置き換える必要があります。

テキスト検索リクエスト

Google Places API テキスト検索サービスは、文字列に基づいて関連するプレイスの情報を返すウェブサービスです。たとえば、「東京のピザ屋」、「新宿駅周辺の靴店」、「123 番地」などを検索できます。このサービスは、テキスト文字列や場所の優先度設定と合致するプレイスのリストをレスポンスとして返します。

自動システムであいまいな住所をクエリする場合このサービスが特に有効で、文字列の住所以外の構成要素を、店舗や住所と照合できます。あいまいな住所のクエリには、不完全な住所、不適切な形式の住所、店舗名など住所以外の要素を含むリクエストなどがあります。

検索レスポンスにはプレイスのリストが含まれます。レスポンス内のプレイスの詳細情報が必要な場合は、プレイス詳細リクエストを送信できます。

使用制限は、Google 周辺検索サービスと Google プレイス テキスト検索サービスとで共通ですが、テキスト検索サービスには 10 倍の乗数が適用されます。つまり、テキスト検索リクエスト 1 回で、リクエスト 10 回分の割り当て量を使用することになります。Google Maps APIs Premium Plan の契約の一部として Google Places API を購入した場合、乗数は異なります。詳しくは、Google Maps APIs Premium Plan のドキュメントをご覧ください。

テキスト検索リクエストは、次の形式の HTTP URL です。

https://maps.googleapis.com/maps/api/place/textsearch/output?parameters

output には次のいずれかの値を設定します。

  • json(推奨)は、出力が JSON(JavaScript Object Notation)であることを示します。
  • xml は、出力が XML であることを示します。

検索リクエストを開始するには、必須のパラメータがいくつかあります。URL の標準と同様に、パラメータはすべてアンパサンド(&)文字を使用して区切ります。

必須パラメータ

  • query: 検索するテキスト文字列(「レストラン」や「123 番地」など)。Google プレイス サービスはこの文字列と一致する候補を、関連性の高い順に並べて結果として返します。検索リクエストに type パラメータも使用している場合、このパラメータは省略可能になります。
  • key: アプリケーションの API キーです。このキーを使って各アプリケーションを識別し、割り当て量を管理します。アプリケーションから追加したプレイスは、そのアプリケーションですぐに利用できるようになります。API プロジェクトを作成してキーを取得する方法を確認するには、Google Places API Web Service のキーの取得をご覧ください。

省略可能なパラメータ

  • location: プレイス情報を取得する位置の緯度と経度を示します。緯度経度 の形式で指定してください。location パラメータを指定する場合は、radius パラメータも指定してください。
  • radius: 検索の結果を優先して返す場所の範囲(メートル単位)を示します。指定可能な最大半径は 50,000 メートルです。この範囲内の検索結果は範囲外のものよりも高くランク付けされますが、知名度の高いプレイスは範囲外でも検索結果に含まれる可能性があります。
  • language: 検索結果を返すときに使用する言語を示す言語コードです(指定できる場合)。また、検索では選択された言語が優先されます。選択された言語での結果は、より上位に表示されます。サポートされる言語とそのコードのリストをご覧ください。サポートされる言語は頻繁に更新されるため、このリストがすべてのサポート言語を網羅しているとは限りません。
  • minpricemaxprice省略可能): 指定した価格帯のプレイスに検索結果を限定します。有効な値の範囲は 0(最も安い)〜4(最も高い)です。それぞれの値が示す金額は地域によって異なります。
  • opennow: クエリが送信された時点で営業しているプレイスのみが返されます。クエリにこのパラメータを指定した場合、Google プレイスのデータベースに営業時間が登録されていないプレイスは返されません。
  • pagetoken: 直前に実行した検索から次の 20 件の結果が返されます。pagetoken パラメータを設定すると、直前の検索と同じパラメータで検索が実行されます。pagetoken 以外のパラメータはすべて無視されます。
  • types: 指定したタイプと一致するプレイスに検索結果を限定します。指定できるタイプは 1 つだけです(複数のタイプを指定すると、最初のエントリの後に指定したタイプはすべて無視されます)。サポートされるタイプのリストをご覧ください。
  • typesサポート終了): 指定した 1 つ以上のタイプと一致するプレイスに検索結果を限定します。タイプはパイプ記号で区切ります(type1|type2|etc)。
  • zagatselectedサポート終了): このパラメータを追加すると(関連値なしのパラメータ名のみ)、Zagat で選ばれたお店やサービスの場所のみに検索が限定されます。このパラメータに true 値や false 値は含められませんzagatselected パラメータは試験中のため、Premium Plan ライセンスを所有する Google Places API のユーザーのみご利用いただけます。

location パラメータと radius パラメータを使用すると、指定した範囲内を優先するように検索結果にバイアスをかけることができます。これによって、Google プレイス サービスが指定した範囲内を優先するように検索結果を絞り込むことができますが、指定した範囲外の結果が返されることもあります。

Google Maps APIs Premium Plan のユーザーへの注意事項:リクエストに API キーを含める必要があります。リクエストに client パラメータや signature パラメータを含めないでください

テキスト検索の例

注: アプリケーションでこのリクエストを実行する場合、この例の key を自分の API キーに置き換える必要があります。

例 1: 次の例は、シドニー近郊のレストランの検索を示しています。

https://maps.googleapis.com/maps/api/place/textsearch/xml?query=restaurants+in+Sydney&key=YOUR_API_KEY

例 2: 次の例は、不完全な住所での検索を示しています。この住所は、国、都道府県、市区町村を含まずに、番地だけを示しています。

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&key=YOUR_API_KEY

例 3: 次の例は、例 2 と同じ不完全な住所での検索を示していますが、検索対象地域の結果が優先されるように location パラメータと radius パラメータを含めています。例 2 と例 3 の結果を比べてください。

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&location=42.3675294,-71.186966&radius=10000&key=YOUR_API_KEY

レーダー検索リクエスト

Google Places API レーダー検索サービスでは、一度に最大 200 件のプレイスを検索できますが、テキスト検索リクエストや周辺検索リクエストで通常返される検索結果よりも詳細度は低くなります。レーダー検索を使用すれば、ユーザーが地域内で具体的なスポットを特定するのに役立つアプリケーションを作成できます。

検索レスポンスには最大 200 件のプレイスが含まれ、各プレイスに関する次の情報のみが含まれます。

  • 地理的座標を含む geometry フィールド。
  • プレイスの詳細情報を取得する際にプレイス詳細リクエストで使用できる place_id。プレイス ID の詳細については、プレイス ID の概要をご覧ください。
  • 廃止予定の reference フィールド。このページの廃止予定のお知らせをご覧ください。

レーダー検索リクエストは、次の形式の HTTP URL です。

https://maps.googleapis.com/maps/api/place/radarsearch/output?parameters

output には次のいずれかの値を設定します。

  • json(推奨)は、出力が JSON(JavaScript Object Notation)であることを示します。
  • xml は、出力が XML であることを示します。

検索リクエストを開始するには、必須のパラメータがいくつかあります。URL の標準と同様に、パラメータはすべてアンパサンド(&)文字を使用して区切ります。

必須パラメータ

  • key: アプリケーションの API キーです。このキーを使って各アプリケーションを識別し、割り当て量を管理します。アプリケーションから追加したプレイスは、そのアプリケーションですぐに利用できるようになります。API プロジェクトを作成してキーを取得する方法を確認するには、Google Places API Web Service のキーの取得をご覧ください。
  • location: プレイス情報を取得する位置の緯度と経度を示します。緯度経度 の形式で指定してください。
  • radius: 検索の結果を返す場所の範囲(メートル単位)を示します。指定可能な最大半径は 50,000 メートルです。
  • レーダー検索リクエストには、keywordnametypes のうち少なくとも 1 つを指定してください。

省略可能なパラメータ

  • keyword: このプレイスに対し Google がインデックスに登録したすべてのコンテンツと突き合わせるキーワードです。名前、タイプ、住所をはじめとして、ユーザーのクチコミや第三者のコンテンツも対象になります。
  • language: 検索結果を返すときに使用する言語を示す言語コードです(指定できる場合)。また、検索では選択された言語が優先されます。選択された言語での結果は、より上位に表示されます。サポートされる言語とそのコードのリストをご覧ください。サポートされる言語は頻繁に更新されるため、このリストがすべてのサポート言語を網羅しているとは限りません。
  • minpricemaxprice省略可能): 指定した価格帯のプレイスに検索結果を限定します。有効な値の範囲は 0(最も安い)〜4(最も高い)です。それぞれの値が示す金額は地域によって異なります。
  • name: このプレイスに対して Google がインデックスに登録したすべてのコンテンツと突き合わせるキーワードです。keyword と同じです。name フィールドは、プレイス名に限定されなくなります。このフィールドの値は、keyword フィールドの値と組み合わされて、同じ検索文字列の一部として渡されます。すべての検索キーワードに keyword パラメータのみを使用することをお勧めします。
  • opennow: クエリが送信された時点で営業しているプレイスのみが返されます。クエリにこのパラメータを指定した場合、Google プレイスのデータベースに営業時間が登録されていないプレイスは返されません。
  • types: 指定したタイプと一致するプレイスに検索結果を限定します。指定できるタイプは 1 つだけです(複数のタイプを指定すると、最初のエントリの後に指定したタイプはすべて無視されます)。サポートされるタイプのリストをご覧ください。
  • typesサポート終了): 指定した 1 つ以上のタイプと一致するプレイスに検索結果を限定します。タイプはパイプ記号で区切ります(type1|type2|etc)。
  • zagatselectedサポート終了): このパラメータを追加すると(関連値なしのパラメータ名のみ)、Zagat で選ばれたお店やサービスの場所のみに検索が限定されます。このパラメータに true 値や false 値は含められませんzagatselected パラメータは試験中のため、Premium Plan ライセンスを所有する Google Places API のユーザーのみご利用いただけます。

Google Maps APIs Premium Plan のユーザーへの注意事項:リクエストに API キーを含める必要があります。リクエストに client パラメータや signature パラメータを含めないでください

レーダー検索の例

注: アプリケーションでこのリクエストを実行する場合、この例の key を自分の API キーに置き換える必要があります。

例 1: 次の例では、イギリスのロンドン周辺の博物館のリストが返されます。

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=51.503186,-0.126446&radius=5000&type=museum&key=YOUR_API_KEY

例 2: keyword、name、types の各パラメータを組み合わせれば、クエリの精度はより高くなります。次の例では、ベジタリアンと記載されたことのあるパリのレストランやカフェが返されます。

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=48.859294,2.347589&radius=5000&type=cafe&keyword=vegetarian&key=YOUR_API_KEY

検索レスポンス

検索レスポンスは、リクエストの URL パスの output フラグで指定された形式で返されます。

次の例では、周辺検索レスポンスを示します。vicinity プロパティではなく formatted_address プロパティを返す点を除き、テキスト検索レスポンスは周辺検索レスポンスと同じです。レーダー検索の場合は、前述のとおり含まれるフィールドが制限されています。

JSON
{
   "html_attributions" : [],
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870775,
               "lng" : 151.199025
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "21a0b251c9b8392186142c798263e289fe45b4aa",
         "name" : "Rhythmboat Cruises",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 270,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAF-LjFR1ZV93eawe1cU_3QNMCNmaGkowY7CnOf-kcNmPhNnPEG9W979jOuJJ1sGr75rhD5hqKzjD8vbMbSsRnq_Ni3ZIGfY6hKWmsOf3qHKJInkm4h55lzvLAXJVc-Rr4kI9O1tmIblblUpg2oqoq8RIQRMQJhFsTr5s9haxQ07EQHxoUO0ICubVFGYfJiMUPor1GnIWb5i8",
               "width" : 519
            }
         ],
         "place_id" : "ChIJyWEHuEmuEmsRm9hTkapTCrk",
         "scope" : "GOOGLE",
         "alt_ids" : [
            {
               "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
               "scope" : "APP"
            }
         ],
         "reference" : "CoQBdQAAAFSiijw5-cAV68xdf2O18pKIZ0seJh03u9h9wk_lEdG-cP1dWvp_QGS4SNCBMk_fB06YRsfMrNkINtPez22p5lRIlj5ty_HmcNwcl6GZXbD2RdXsVfLYlQwnZQcnu7ihkjZp_2gk1-fWXql3GQ8-1BEGwgCxG-eaSnIJIBPuIpihEhAY1WYdxPvOWsPnb2-nGb6QGhTipN0lgaLpQTnkcMeAIEvCsSa0Ww",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "Pyrmont Bay Wharf Darling Dr, Sydney"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866891,
               "lng" : 151.200814
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "45a27fd8d56c56dc62afc9b49e1d850440d5c403",
         "name" : "Private Charter Sydney Habour Cruise",
         "photos" : [
            {
               "height" : 426,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAL3n0Zu3U6fseyPl8URGKD49aGB2Wka7CKDZfamoGX2ZTLMBYgTUshjr-MXc0_O2BbvlUAZWtQTBHUVZ-5Sxb1-P-VX2Fx0sZF87q-9vUt19VDwQQmAX_mjQe7UWmU5lJGCOXSgxp2fu1b5VR_PF31RIQTKZLfqm8TA1eynnN4M1XShoU8adzJCcOWK0er14h8SqOIDZctvU",
               "width" : 640
            }
         ],
         "place_id" : "ChIJqwS6fjiuEmsRJAMiOY9MSms",
         "scope" : "GOOGLE",
         "reference" : "CpQBhgAAAFN27qR_t5oSDKPUzjQIeQa3lrRpFTm5alW3ZYbMFm8k10ETbISfK9S1nwcJVfrP-bjra7NSPuhaRulxoonSPQklDyB-xGvcJncq6qDXIUQ3hlI-bx4AxYckAOX74LkupHq7bcaREgrSBE-U6GbA1C3U7I-HnweO4IPtztSEcgW09y03v1hgHzL8xSDElmkQtRIQzLbyBfj3e0FhJzABXjM2QBoUE2EnL-DzWrzpgmMEulUBLGrtu2Y",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "Australia"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870943,
               "lng" : 151.190311
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "30bee58f819b6c47bd24151802f25ecf11df8943",
         "name" : "Bucks Party Cruise",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAA48AX5MsHIMiuipON_Lgh97hPiYDFkxx_vnaZQMOcvcQwYN92o33t5RwjRpOue5R47AjfMltntoz71hto40zqo7vFyxhDuuqhAChKGRQ5mdO5jv5CKWlzi182PICiOb37PiBtiFt7lSLe1SedoyrD-xIQD8xqSOaejWejYHCN4Ye2XBoUT3q2IXJQpMkmffJiBNftv8QSwF4",
               "width" : 800
            }
         ],
         "place_id" : "ChIJLfySpTOuEmsRsc_JfJtljdc",
         "scope" : "GOOGLE",
         "reference" : "CoQBdQAAANQSThnTekt-UokiTiX3oUFT6YDfdQJIG0ljlQnkLfWefcKmjxax0xmUpWjmpWdOsScl9zSyBNImmrTO9AE9DnWTdQ2hY7n-OOU4UgCfX7U0TE1Vf7jyODRISbK-u86TBJij0b2i7oUWq2bGr0cQSj8CV97U5q8SJR3AFDYi3ogqEhCMXjNLR1k8fiXTkG2BxGJmGhTqwE8C4grdjvJ0w5UsAVoOH7v8HQ",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "37 Bank St, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867591,
               "lng" : 151.201196
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "a97f9fb468bcd26b68a23072a55af82d4b325e0d",
         "name" : "Australian Cruise Group",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 242,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAABjeoPQ7NUU3pDitV4Vs0BgP1FLhf_iCgStUZUr4ZuNqQnc5k43jbvjKC2hTGM8SrmdJYyOyxRO3D2yutoJwVC4Vp_dzckkjG35L6LfMm5sjrOr6uyOtr2PNCp1xQylx6vhdcpW8yZjBZCvVsjNajLBIQ-z4ttAMIc8EjEZV7LsoFgRoU6OrqxvKCnkJGb9F16W57iIV4LuM",
               "width" : 200
            }
         ],
         "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
         "scope" : "GOOGLE",
         "reference" : "CoQBeQAAAFvf12y8veSQMdIMmAXQmus1zqkgKQ-O2KEX0Kr47rIRTy6HNsyosVl0CjvEBulIu_cujrSOgICdcxNioFDHtAxXBhqeR-8xXtm52Bp0lVwnO3LzLFY3jeo8WrsyIwNE1kQlGuWA4xklpOknHJuRXSQJVheRlYijOHSgsBQ35mOcEhC5IpbpqCMe82yR136087wZGhSziPEbooYkHLn9e5njOTuBprcfVw",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "32 The Promenade, King Street Wharf 5, Sydney"
      }
   ],
   "status" : "OK"
}

JSON レスポンスには、4 つ のルート要素があります。

  • status にはリクエストについてのメタデータが含まれます。下記のステータス コードをご覧ください。
  • "results" にはプレイスの配列と各プレイスの情報が含まれます。これらの結果については、検索結果をご覧ください。Places API はクエリ 1 回あたり最大 20 件の establishment 結果を返します。また、リクエストの場所の範囲を識別する political 結果が返される場合もあります。
  • html_attributions には、ユーザーに表示する必要がある、このリストに関する一連の属性情報が含まれます。
  • next_page_token にはトークンが含まれ、このトークンを使って最大 20 件の追加結果を返すことができます。表示する追加結果がない場合は、next_page_token は返されません。返すことができる検索結果の最大数は 60 です。next_page_token が発行されてから有効になるまでに少し時間がかかります。

JSON レスポンスの解析方法については、Javascript による JSON の処理をご覧ください。

XML
<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>Pyrmont Bay Wharf Darling Dr, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8707750</lat>
    <lng>151.1990250</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CoQBdAAAAChhtoQX_467esHavS0Sj9DrY306W3_uDXKmB2us8Eh7_dX7rDuln18i_uqocF_LmzRptuFr6WZs7aeBSLFq8VFmckxFjsXDaqMdd3gvxi_5dIwPTEugQQYG9oJA-YnYfPBvjGtuoMfNnjyU2GuxGRmJjCO77pEAbsTLq44eBG5jEhAvkKHCGqIzqgC9tdOb1dSqGhRA1hhG4pvILD5OEAq6W8L8sXbkug</reference>
  <id>21a0b251c9b8392186142c798263e289fe45b4aa</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAiRA8ls6lx5LTfLuHJtLYvz73LXIMa5EVsHz2OUjh70LBPBnIEULZ57w076gOuyCeJqP041_v-ek3I5C4IkqW7YgA0EBybwywfIcUXsj5W_qiJR2yaXHXI-FmDM6j1zaS0sJQnNJhe4Bl9W42Jx16phIQRmNOWKGIemKLgzNEPcCnmBoUGgr0gWQBwWd8HAseR-5ie3JYuIM</photo_reference>
   <width>519</width>
   <height>270</height>
  </photo>
 </result>
 <result>
  <name>Private Charter Sydney Habour Cruise</name>
  <vicinity>Australia</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8668910</lat>
    <lng>151.2008140</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJqwS6fjiuEmsRJAMiOY9MSms</place_id>
  <scope>GOOGLE</scope>
  <reference>CpQBhQAAAKGKrbbnAW3_eAypKW9bhAzAuSmaqAogs7MTFxsntDqCzt-gKD9nz-zqNsk0uJsl0yCUYpNYjHz_yzmh3J_4TTxpxIqdaq2uDvfoTYtvm8FkxMAkK3cS7k9t3Ze2aHRWnxlN9hczK2xlc5taDE7xAGOHF5Xe5IlVV1wV66sOrWrlHtGh47lqT9Id86eG2OmlVhIQo4djLtRkceg-zaYjULYEjRoUToVEyOUVCFfZMUs_E7ZLSzjFmcg</reference>
  <id>45a27fd8d56c56dc62afc9b49e1d850440d5c403</id>
  <photo>
   <photo_reference>CnRnAAAAUW97jpK2_C2Lh4jLPVKZlhyS84mqZxvVmWFdc6jdl3XxjzKbYdbJpz0PGW5eFRw6kTKYNZM9QvRf-csFegHILZxLCLJ-6ZnbdEXbVM4kBzOb-rhchJx1KC6LHs_vVWP8bK96569lFYRf7Hn8ylQrlhIQb69_dcZVwqQhREsHW6azWhoU0XMWqZMBBzx-hgpduAaeErOFg8E</photo_reference>
   <width>640</width>
   <height>426</height>
  </photo>
 </result>
 <result>
  <name>Bucks Party Cruise</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8709430</lat>
    <lng>151.1903110</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJLfySpTOuEmsRsc_JfJtljdc</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBdAAAAOMUoYamsekTDxBDVyKZ-E54VQ6HjirVzAZBBwz5gcn5KTfmemmwmOAtLcvRScp1NLQmj-fBYzEO2Gq_cO4Dc12PG0_twzDv9zq3KIyNQVuO-r0n1eQVj8Dlng-n4c1F2hMxufCNVp4-QfjMj81qXJm0invQMUc1xNgZRyiOpLe9EhDLn0KiVWEFKOURYsWrHRouGhR7YMJxYmFs-OXjKyzQKGdQXLrzPw</reference>
  <id>30bee58f819b6c47bd24151802f25ecf11df8943</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAjboYP9Ujxe5SmZFN5AJc42AWtpYFX9wYdqjcTXavXJlfoXdHPC2hErdbHcaeYJBNPV6CzoDc2RLw_w9HofGOhCWHtoAl9b3g8TZZjnZobnAHxoljUdgV8PXyd-pCO-QHKOtiKfIdUmF4HRj2QHj6OhIQhLNpoKNKP8MNjk90M4KGrhoUW2NyBgsWjRpUEoWlt0fD48BhEcQ</photo_reference>
   <width>800</width>
   <height>600</height>
  </photo>
 </result>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>32 The Promenade, King Street Wharf 5, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675910</lat>
    <lng>151.2011960</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJrTLr-GyuEmsRBfy61i59si0</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBeAAAAJZA0WY2pKnZ6nNnxNd_pSDA2NilDLfGDf7pTt7VssxB5tMYE7400w3HZHRav2unpKRhEp7lrh0yKcVdSfKYIz85k1SExoLGmYD8NIf1dPr8KlkRWOYZUTLGp623r5hAzEGk94mPleF4s50pWqLrhAzwvJb1tGj2ak-2PXQORkeTEhAfTj6tMFo_tRWZYOnYCxiVGhQA3n-KV7AW5MvJlGaIDHuLyyEBBA</reference>
  <id>a97f9fb468bcd26b68a23072a55af82d4b325e0d</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAhTkpwozMoZx_NXMkIrKdcEGe46BmPy3GPCfS-gkCK5PlR8rFDY9DtD_7wFYAIdhVoZz3I9QguRNbil5y37jTU-03GJ_LqVw_avSxFkT0g2kU0K5z2VYnAsgNsrbsK_EVglhg5PrDybC1tAVKCXSGsRIQOcdlAVnC1Qc46YLWjlqdyxoUL5JGZgczfo1jxLxhDeGs8OvBQCk</photo_reference>
   <width>200</width>
   <height>242</height>
  </photo>
 </result>
</PlaceSearchResponse>

XML レスポンス は 1 つの <PlaceSearchResponse> 要素と 4 つの最上位要素で構成されます。

  • <status> にはリクエストについてのメタデータが含まれます。下記のステータス コードをご覧ください。
  • <result> 要素(ゼロ個以上)には、各要素に 1 つの施設に関する情報が含まれます。これらの結果については、周辺検索結果をご覧ください。Places API はクエリ 1 回あたり最大 20 件の establishment 結果を返します。また、リクエストの場所の範囲を識別する political <type> 結果や道路情報が返される場合もあります。
  • next_page_token にはトークンが含まれ、このトークンを使って最大 20 件の追加結果を返すことができます。表示する追加結果がない場合は、next_page_token は返されません。返すことができる検索結果の最大数は 60 です。next_page_token は、最初に発行されてから 2 秒後に有効になります。
  • html_attributions には、ユーザーに表示する必要がある、このリストに関する一連の属性情報が含まれます。

ステータス コード

検索レスポンス オブジェクトの "status" フィールドには、リクエストのステータスが含まれます。リクエストが失敗した原因を追跡できるようにデバッグ情報が含まれることもあります。status フィールドの有効な値は次のとおりです。

  • OK: エラーが発生せず、プレイスが正常に検出され、少なくとも 1 つの結果が返されたことを示します。
  • ZERO_RESULTS: 検索は成功したものの結果が返されなかったことを示します。これは、検索に遠隔地の latlng が渡された場合に発生することがあります。
  • OVER_QUERY_LIMIT: リクエスト数が割り当て量を超えていることを示します。
  • REQUEST_DENIED: リクエストが拒否されたことを示します。通常は、無効な key パラメータが指定されていないことが原因です。
  • INVALID_REQUEST: 通常は、必須のクエリ パラメータ(locationradius)が指定されていないことを示します。

エラー メッセージ

Google プレイス サービスで OK 以外のステータス コードが返された場合、検索レスポンス オブジェクト内に error_message フィールドが付加されている場合があります。このフィールドには、返されたステータス コードの原因に関する詳細情報が含まれています。

検索結果

Google プレイス サービスが JSON 形式で検索結果を返す場合、検索結果は results 配列に格納されます。サービスから返す結果がない(たとえば、location が遠く離れている)場合でも、空の results 配列が返されます。XML レスポンスは、ゼロ個以上の <result> 要素で構成されます。

results 配列の各要素には、指定範囲(locationradius)内の検索結果が 1 件ずつ、知名度の順に格納されます。

検索結果には、ユーザーに表示する必要がある属性情報が含まれる場合もあります。これは、JSON 形式での属性の例です。

"html_attributions" : [
      "Listings by \u003ca href=\"http://www.example.com/\"\u003eExample Company\u003c/a\u003e"
],
これは、XML 形式の属性です。
<html_attribution>Listings by <a href="http://www.example.com/">Example Company</a></html_attribution>

results 配列内の各結果には次のフィールドが含まれます。

  • icon には、結果を示すときにユーザーに表示するお勧めアイコンの URL が含まれます。
  • id には、このプレイスを示す一意で不変の ID が含まれます。この ID を使用してこのプレイスに関する情報を取得することはできませんが、セッションが変わってもこの ID は常に同じです。この ID はこのプレイスに関するデータを統合したり、個々の検索でプレイスを特定するのに使用できます。注: place_id の導入により、id は廃止されました。このページの廃止予定のお知らせをご覧ください。
  • geometry には、検索結果のジオメトリ情報が含まれます。通常は、プレイスの location(ジオコード)と、検索対象範囲を示す viewport(省略可能)で構成されます。
  • name には、返された結果が人の読める形式で名前として含まれます。establishment の場合、通常は店名やサービス名です。
  • opening_hours には、次の情報が含まれます。
    • open_now は、プレイスが現在営業しているかどうかを示す Boolean 型の値です。
  • photos[]: photo オブジェクトの配列で、各オブジェクトには画像の参照が含まれます。プレイス検索で返される photo オブジェクトは 1 つのみです。その場所でプレイス詳細リクエストを実行すると、最大 10 件の写真が返されます。プレイスフォトと、アプリケーションでの画像の使い方についての詳細は、プレイスフォトについての説明をご覧ください。photo オブジェクトは次のように表されます。
    • photo_reference: フォト リクエストを実行する際に写真を識別するための文字列です。
    • height: 画像の最大高さ。
    • width: 画像の最大幅。
    • html_attributions[]: 必要な属性情報が含まれます。このフィールドは常に存在しますが、値が空の場合もあります。
  • place_id: プレイスを一意に識別するテキスト表記の ID です。プレイスの情報を取得するには、この ID を Places API リクエストの placeId フィールドに渡します。プレイス ID の詳細については、プレイス ID の概要をご覧ください。
  • scope: place_id の範囲を示します。有効な値は次のとおりです。
    • APP:プレイス ID が自分のアプリケーションでのみ認識されます。これは、そのプレイスが自分のアプリケーションに追加され、まだモデレーション プロセスを通過していないことが理由です。
    • GOOGLE:プレイス ID を他のアプリケーションや Google マップでも利用できます。
    注: scope フィールドは、周辺検索結果とプレイス詳細結果にのみ含まれます。app-scoped プレイスは、周辺検索リクエストとプレイス詳細リクエストからのみ取得可能です。レスポンスに scope フィールドが存在しない場合、スコープは GOOGLE であるとみなしてよいでしょう。
  • alt_ids: ゼロまたは 1 つ以上の代替プレイス ID の配列。代替 ID にはそれぞれ固有のスコープが関連付けられます。注: この配列は、空または存在しない場合があります。存在する場合は、次のフィールドが含まれています。
    • place_id: 代替プレイス ID が存在する一番の理由は、自分のアプリケーションでプレイスを追加して Application-scoped のプレイス ID を取得した後、モデレーション プロセスで承認を受けて Google-scoped のプレイス ID を取得するためです。
    • scope: 代替プレイス ID のスコープは常に APP になり、その代替プレイス ID は自分のアプリケーションでのみ認識されます。
    たとえば、アプリケーションがプレイスを追加して、新しいプレイスの AAA という place_id を取得したとします。その後、プレイスがモデレーション プロセスを終えて Google-scoped の BBB という place_id を取得します。この時点以降、このプレイスには次の情報が含まれるようになります。
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level: プレイスの価格レベル。0~4 の値で表します。それぞれの値が示す金額は地域によって異なります。価格レベルの意味は次のとおりです。
    • 0: 無料
    • 1: 安い
    • 2: 普通
    • 3: やや高い
    • 4: 非常に高い
  • rating には、ユーザーのクチコミの集計に基づくプレイスの評価(1.0~5.0)が含まれます。
  • reference には、一意のトークンが含まれます。プレイス詳細リクエストでは、このトークンを使ってこのプレイスに関する追加情報を取得できます。このトークンはプレイスを一意に識別しますが、その逆は成り立ちません。プレイスには複数の有効な reference トークンがある場合があります。どのプレイスでも、検索ごとに同じトークンが返されるとは限りません。注: place_id の導入により、reference は廃止されました。このページの廃止予定のお知らせをご覧ください。
  • types[] には、指定された結果を表す対象物タイプの配列が含まれます。詳しくは、サポートされるタイプのリストをご覧ください。検索結果に複数のタイプが割り当てられている場合、XML レスポンスには複数の <type> 要素が含まれます。
  • vicinity には、周辺の場所の対象物名が含まれます。通常、この対象物は、その検索結果内の道路や周辺地区を示します。vicinity プロパティが返されるのは、周辺検索の場合のみです。
  • formatted_address は、このプレイスの住所が人の読める形式で含まれる文字列です。ほとんどの場合、この住所は「郵便の宛先」と同一です。formatted_address プロパティが返されるのは、テキスト検索の場合のみです。
  • permanently_closed は、そのプレイスが恒久的に休業していることを示す Boolean 型のフラグです(値 true)。そのプレイスが恒久的に閉鎖されているのではない場合、このフラグはレスポンスに含まれません。

プレミアム データ

上記のフィールドに加えて、Premium Plan ライセンスを所有する Google Places API ユーザー向けに次のフィールドが用意されています。これらは result フィールドの最上位の子フィールドとして表示されます。

  • aspects には、その施設のメイン評価に対する 1 つの AspectRating オブジェクトが含まれます。各 AspectRating は次のように表されます。
    • type は、評価対象の特徴の名称です。サポートされるタイプは、appealatmospheredecorfacilitiesfoodoverallqualityservice です。
    • rating: 特定の特徴に対する集約評価(0~30)です。集約評価の範囲は 0~30 ですが、クチコミの一部として表示される評価の範囲は 0~3 です。
  • zagat_selected は、プレイスが Zagat クオリティの場所として選択されたことを示します。Zagat ラベルがあるプレイスは、常に品質が高いことや他にはない特性を持っていることで知られています。
詳細については、プレミアム データをご覧ください。

追加結果へのアクセス

デフォルトでは、周辺検索やテキスト検索で、クエリ 1 回あたりに返すことができる establishment 結果は最大 20 件です。ただし、各検索では、3 ページに分けて最大 60 件の結果を返すことができます。検索結果が 20 件を超える場合、検索レスポンスには追加の値、つまり next_page_token が含まれます。next_page_token の値を新しい検索の pagetoken パラメータに渡すと、次の結果セットが表示されます。next_page_token が null または返されなかった場合、それ以上の結果はありません。next_page_token が発行されてから有効になるまでに少し時間がかかります。入手可能になる前に次のページをリクエストすると、INVALID_REQUEST レスポンスが返されます。同じ next_page_token でリクエストをもう一度実行すると、次のページの結果が返されます。

たとえば、下記のクエリでは、オーストラリア、シドニーのダーリング ハーバー周辺のレストランが検索され、距離順に並べて結果が返されます。レスポンスに next_page_token プロパティが含まれていることがわかります。

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&rankby=distance&types=food&key=YOUR_API_KEY
{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867217,
               "lng" : 151.195939
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/cafe-71.png",
         "id" : "7eaf747a3f6dc078868cd65efc8d3bc62fff77d7",
         "name" : "Biaggio Cafe - Pyrmont",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAmWmj0BqA0Jorm1_vjAvx1n6c7ZNBxyY-U9x99-oNyOxvMjDlo2npJzyIq7c3EK1YyoNXdMFDcRPzwLJtBzXAwCUFDGo_RtLRGBPJTA2CoerPdC5yvT2SjfDwH4bFf5MrznB0_YWa4Y2Qo7ABtAxgeBIQv46sGBwVNJQDI36Wd3PFYBoUTlVXa0wn-zRITjGp0zLEBh8oIBE",
               "width" : 900
            }
         ],
         "place_id" : "ChIJIfBAsjeuEmsRdgu9Pl1Ps48",
         "scope" : "GOOGLE",
         "price_level" : 1,
         "rating" : 3.4,
         "reference" : "CoQBeAAAAGu0wNJjuZ40DMrRe3mpn7fhlfIK1mf_ce5hgkhfM79u-lqy0G2mnmcueTq2JGWu9wsgS1ctZDHTY_pcqFFJyQNV2P-kdhoRIeYRHeDfbWtIwr3RgFf2zzFBXHgNjSq-PSzX_OU6OT2_3dzdhhpV-bPezomtrarW4DsGl9uh773yEhDJT6R3V8Fyvl_xeE761DTCGhT1jJ3floFI5_c-bHgGLVwH1g-cbQ",
         "types" : [ "cafe", "bar", "restaurant", "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866786,
               "lng" : 151.195633
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
         "id" : "3ef986cd56bb3408bc1cf394f3dad9657c1d30f6",
         "name" : "Doltone House",
         "photos" : [
            {
               "height" : 1260,
               "html_attributions" : [ "From a Google User" ],
               "photo_reference" : "CnRwAAAAeM-aLqAm573T44qnNe8bGMkr_BOh1MOVQaA9CCggqtTwuGD1rjsviMyueX_G4-mabgH41Vpr8L27sh-VfZZ8TNCI4FyBiGk0P4fPxjb5Z1LrBZScYzM1glRxR-YjeHd2PWVEqB9cKZB349QqQveJLRIQYKq2PNlOM0toJocR5b_oYRoUYIipdBjMfdUyJN4MZUmhCsTMQwg",
               "width" : 1890
            }
         ],
         "place_id" : "ChIJ5xQ7szeuEmsRs6Kj7YFZE9k",
         "scope" : "GOOGLE",
         "reference" : "CnRvAAAA22k1PAGyDxAgHZk6ErHh_h_mLUK_8XNFLvixPJHXRbCzg-gw1ZxdqUwA_8EseDuEZKolBs82orIQH4m6-afDZV9VcpggokHD9x7HdMi9TnJDmGb9Bdh8f-Od4DK0fASNBL7Me3CsAWkUMWhlNQNYExIQ05W7VbxDTQe2Kh9TiL840hoUZfiO0q2HgDHSUyRdvTQx5Rs2SBU",
         "types" : [ "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "aspects" : [
            {
               "rating" : 23,
               "type" : "overall"
            }
         ],
      ...
   ],
   "status" : "OK"
}

次の結果セットを表示するには、新しいクエリを発行して next_page_token の結果を pagetoken パラメータに渡します。次に例を示します。

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

pagetoken を設定すると、他のパラメータはすべて無視されます。クエリでは、以前と同じ検索が実行されますが、返されるのは新しい結果セットです。最初のクエリの後、最大 2 回まで新しいページをリクエストできます。各結果ページは順番に表示する必要があります。1 回のクエリに対して、検索結果が 2 ページ以上表示されないようにしてください。なお、検索 1 回でリクエスト 1 回分の割り当て量を使用することになります。

sensor パラメータ

Google Places API では、以前はユーザーの位置情報の検出にアプリケーションでセンサーを使用するかどうかを示すため sensor パラメータを含める必要がありましたが、このパラメータは必要なくなりました。

フィードバックを送信...