Text Search（従来版）

欧州経済領域（EEA）のデベロッパー

テキスト検索（従来版）は、「渋谷 ピザショップ」「表参道 靴店」「123 番地」といった文字列に対して、場所のセットについての情報を返します。テキスト文字列と、その時点で設定済みの地域バイアスをもとに、場所のリストを返すサービスです。

テキスト検索（従来版）は、次のような曖昧なクエリを想定していません。

クエリタイプ 例
1 つのクエリに複数の場所、道路、都市の名前が含まれているなど、コンセプトや制約が多すぎる 「マーケット ストリート サンフランシスコ サンノゼ空港」
Google マップに表示されない住所要素 "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
ビジネス、チェーン、カテゴリの名前と、それらのエンティティが利用できない場所を組み合わせたもの 「テキサス州ダラス近くのテスコ」
複数の解釈が可能な曖昧なクエリ 「充電器のドロップオフ」
現在使用されていない過去の名前 "Middlesex United Kingdom"
地理空間以外の要素または意図 「ベンチュラ港には何隻のボートがありますか？」
非公式の名前やバニティ名 「ジェンガ」
「ヘルター スケルター」
緯度と経度の座標 "37.422131,-122.084801"

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

テキスト検索（従来版）リクエスト

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

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

ここで、output には次のいずれかの値を指定できます。

  • json（推奨）は、JavaScript Object Notation（JSON）での出力を示します。
  • xml は、XML としての出力を示します。

検索リクエストを開始するには、特定のパラメータが必要です。URL の標準規則と同様に、すべてのパラメータはアンパサンド（&）文字を使用して区切ります。

必須パラメータ

  • クエリ

    検索するテキスト文字列（「レストラン」、「123 番通り」など）です。地名、住所、施設のカテゴリのいずれかを入力する必要があります。他の種類のテキストを入力した場合、有効な結果が返されず、エラーが発生する場合があります。Google プレイス サービスはこの文字列と一致する候補を、関連性の高い順に並べて結果として返します。

  • 半径

    場所の結果を返す距離（メートル単位）を定義します。location パラメータと radius パラメータを渡すことで、バイアスを設定し、指定した円の範囲内の結果を優先します。これによって、プレイス サービスが指定した範囲内を優先するように検索結果を絞り込むことができますが、指定した範囲外の結果が返されることもあります。

    半径は、検索の種類やその他のパラメータに応じて、自動的に最大値に制限されます。

    • 予測入力: 50,000 メートル
    • Nearby Search:
      • keyword または name の場合: 50,000 メートル
      • keyword または name なし
        • 最大 50,000 m。rankby パラメータとは無関係に、エリアの密度に基づいて動的に調整されます。
        • rankby=distance を使用する場合、radius パラメータは受け入れられず、INVALID_REQUEST が返されます。
    • Query Autocomplete: 50,000 メートル
    • テキスト検索: 50,000 メートル

オプション パラメータ

  • 言語

    結果を返す言語。

    • サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
    • language が指定されていない場合、API は Accept-Language ヘッダーで指定された優先言語を使用しようとします。
    • API は、ユーザーと現地の人の両方が読み取れる番地を提供するように最善を尽くします。この目標を達成するため、住所は現地語で返されます。必要に応じて、ユーザーが読み取れる文字に変換され、優先言語が考慮されます。その他の住所はすべて、優先言語で返されます。住所コンポーネントはすべて同じ言語で返されます。この言語は、最初のコンポーネントから選択されます。
    • 優先言語で名前が利用できない場合、API は最も近い一致を使用します。
    • 優先言語は、API が返す結果のセットと、それらが返される順序にわずかに影響します。ジオコーダは、言語に応じて略語を異なる方法で解釈します。たとえば、道路タイプの略語や、ある言語では有効でも別の言語では有効でない類義語などです。たとえば、utca と tér は、ハンガリー語で「通り」の同義語です。

  • ロケーション

    場所情報を取得する中心点。これは latitude,longitude として指定する必要があります。

    query に Market in Barcelona などの明示的な場所が含まれている場合、location パラメータはオーバーライドされることがあります。クエリを引用符で囲むと、location と radius に割り当てられる重みにも影響する可能性があります。

  • maxprice

    指定した範囲内の場所に結果を制限します。有効な値の範囲は 0（最も安い）〜4（最も高い）です。特定の値で示される正確な金額は、地域によって異なります。

  • minprice

    指定した範囲内の場所に結果を制限します。有効な値の範囲は 0（最も安い）〜4（最も高い）です。特定の値で示される正確な金額は、地域によって異なります。

  • opennow

    クエリが送信された時点で営業している場所のみを返します。クエリにこのパラメータを指定した場合、Google プレイスのデータベースに営業時間が登録されていない場所は返されません。

  • pagetoken

    以前に実行した検索から最大 20 件の結果を返します。pagetoken パラメータを設定すると、以前に使用したパラメータと同じパラメータで検索が実行されます。pagetoken 以外のパラメータはすべて無視されます。

  • 地域

    地域コード。ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ）です。

  • type

    指定したタイプに一致する場所のみに結果を制限します。指定できるタイプは 1 つだけです。複数のタイプを指定すると、最初のエントリの後に指定したタイプはすべて無視されます。

    • type=hospital|pharmacy|doctor を type=hospital に変更します。
    • type=hospital,pharmacy,doctor は完全に無視されます。

    サポートされているタイプのリストをご覧ください。

    注: keyword と type を同じ値 (keyword=cafe&type=cafe または keyword=parking&type=parking ) で加算すると、ZERO_RESULTS になります。

テキスト検索（従来版）の例

注: 以下の例では、アプリケーションでリクエストが機能するように、key を独自の API キーに置き換える必要があります。

基本的な例

次の例は、シドニー近郊のレストランを検索するものです。

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

不完全な住所の例

次の例は、不完全な住所（この場合は、市区町村、都道府県、国を含まない番地）を検索しています。

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

位置バイアスの例

次の例は、前の例と同じ不完全な住所を検索するもので、location パラメータと radius パラメータを含めて、結果を目的の地域にバイアスしています。

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

テキスト検索（従来版）のレスポンス

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

次の例は、テキスト検索（従来版）のレスポンスを示しています。

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

フィールド 必須 タイプ 説明
required Array<string>

このリスティングに関する一連の帰属情報が含まれる場合があります。この情報はユーザーに表示する必要があります（一部のリスティングには帰属情報がない場合があります）。

required Array<Place>

場所の配列が含まれます。

Place Search リクエストでは、Place Details リクエストで返されるフィールドのサブセットが返されます。目的のフィールドが Place Search で返されない場合は、Place Search を使用して place_id を取得してから、そのプレイス ID を使用して Place Details リクエストを実行します。

詳細については、Place をご覧ください。
required PlacesSearchStatus

リクエストのステータスが格納されます。リクエストが失敗した原因を追跡できるようにデバッグ情報が格納される場合もあります。

詳細については、PlacesSearchStatus をご覧ください。

省略可 文字列

サービスが OK< 以外のステータス コードを返した場合、レスポンス オブジェクト内に error_message フィールドが追加されていることがあります。このフィールドには、指定されたステータス コードの理由に関する詳細情報が含まれます。このフィールドは常に返されるとは限りません。また、その内容は変更される可能性があります。

省略可 Array<string>

サービスがリクエスト仕様に関する追加情報を返す場合、レスポンス オブジェクト内に追加の info_messages フィールドが存在することがあります。このフィールドは、リクエストが成功した場合にのみ返されます。常に返されるとは限りません。また、内容は変更される可能性があります。

next_page_token

省略可 文字列

最大 20 件の追加の結果を返すために使用できるトークンが含まれています。表示する追加の結果がない場合、next_page_token は返されません。返される結果の最大数は 60 です。next_page_token が発行されてから有効になるまでには、短い遅延があります。

PlacesSearchStatus

サービスから返されるステータス コード。

  • OK は、API リクエストが成功したことを示します。
  • ZERO_RESULTS は、検索は成功したものの結果が返されなかったことを示します。これは、遠隔地の latlng が検索に渡された場合に発生することがあります。
  • INVALID_REQUEST は、API リクエストの形式が正しくないことを示します。通常は、必須のクエリ パラメータ（location または radius）が不足していることが原因です。
  • OVER_QUERY_LIMIT。次のいずれかを示します。
    • QPS の上限を超えている。
    • アカウントで課金が有効になっていない。
    • 毎月 200 ドル分のクレジット、またはご自身で設定した使用量の上限を超えている。
    • 設定したお支払い方法が無効になっている（クレジット カードの期限切れなど）
    このエラーを解決する方法の詳細については、Maps に関するよくある質問をご覧ください。
  • REQUEST_DENIED は、リクエストが拒否されたことを示します。一般的には、次の理由が考えられます。
    • リクエストに API キーがありません。
    • key パラメータが無効です。
  • UNKNOWN_ERROR は、不明なエラーが発生したことを示します。

場所

Place Search のレスポンスでは、Place フィールドの次のサブセットが返されます。すべての属性がすべての場所タイプで使用できるわけではありません。Place Search で返されないフィールド（address_components、formatted_phone_number、reviews、website など）を取得するには、返された place_id を Place Details（従来版）リクエストで渡します。エンドポイント全体のフィールドの可用性と料金階層については、プレイスデータ フィールド（レガシー）をご覧ください。

フィールド タイプ 説明
business_status string その場所の営業状況を示します（場所がお店やサービスの場合）。OPERATIONAL、CLOSED_TEMPORARILY、CLOSED_PERMANENTLY のいずれかです。ステータス データが存在しない場合は省略されます。
formatted_address string この場所の人が読める形式の住所。テキスト検索（従来版）と Find Place（従来版）によって返されます。フォーマット済み住所は、プログラムで解析しないでください。代わりに、Place Details（従来版）で address_components をリクエストしてください。
geometry Geometry lat 座標と lng 座標を持つジオコーディングされた location と、northeast 境界と southwest 境界を持つ優先 viewport が含まれます。
icon string この結果を地図上に表示する際に使用できる、推奨アイコンの URL。
icon_background_color string 場所のカテゴリのデフォルトの 16 進数色コード。
icon_mask_base_uri string 推奨アイコンのベース URL。SVG または PNG のファイル形式の拡張子は含まれません。
name string 返された結果の人が読める形式の名前。establishment の結果の場合、この値は通常、正規化されたビジネス名です。
opening_hours PlaceOpeningHours 営業時間に関する情報。Place Search エンドポイントは、open_now ブール値サブフィールドのみを返します。periods と weekday_text については、Place Details（従来版）で opening_hours をリクエストします。
permanently_closed boolean 非推奨: business_status を使用してお店やサービスの営業状況を確認してください。
photos Array<PlacePhoto> PlacePhoto オブジェクトの配列。各オブジェクトには、photo_reference、height、width、html_attributions が含まれます。使用方法の詳細については、Place Photos（従来版）をご覧ください。
place_id string 場所を一意に識別するテキスト表記の ID。この ID を Place Details（従来版）リクエストの place_id パラメータに渡します。プレイス ID の概要をご覧ください。
plus_code PlusCode 緯度と経度の座標から派生したエンコードされた場所の参照。global_code とオプションの compound_code が含まれます。
price_level integer 場所の価格レベル。0 から 4 の範囲で、最も安いものから最も高いものまでを表します。price_level をご覧ください。
rating number ユーザーのクチコミの集計に基づく場所の評価（1.0～5.0）。
reference string 非推奨: 代わりに place_id を使用してください。
scope string 非推奨: place_id のスコープを示します。これは常に GOOGLE です。Nearby Search（従来版）によって返されます。
types Array<string> 指定された結果を記述する特徴タイプの配列。プレイスタイプ（従来版）をご覧ください。
user_ratings_total integer この場所の評価の合計数（レビュー テキストの有無にかかわらず）。
vicinity string 場所の簡単な住所です。番地や市町村などが含まれ、州、都道府県、郵便番号、国などは含まれません。Nearby Search（従来版）によって返されます。

追加の結果へのアクセス

デフォルトでは、各レスポンスは 1 つのクエリに対して最大 20 件の establishment の結果を返します。ただし、各検索では、3 ページに分けて最大 60 件の結果を返すことができます。検索結果が 20 件を超える場合、検索レスポンスには追加の値 next_page_token が含まれます。next_page_token の値を新しいリクエストの pagetoken パラメータに渡して、次の結果セットを表示します。

  • next_page_token が null であるか、返されない場合、それ以上の結果はありません。
  • 同じ next_page_token を使用してリクエストを再試行すると、結果の次のページが返されます。
  • pagetoken を設定すると、他のパラメータは無視されます。
  • 元のクエリに続いて、新しいページを 2 回までリクエストできます。
  • next_page_token を使用するリクエストを含む各リクエストは、使用量上限に対して 1 件のリクエストとしてカウントされ、個別に課金されます。
  • next_page_token が発行されてから有効になるまでには数秒の遅延があります。次のページが利用可能になる前にリクエストすると、INVALID_REQUEST レスポンスが返されます。next_page_token を含むリクエストには常に課金されます。

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

{
   "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" : [...]
   "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