Find Place（従来版）

Find Place（従来版）リクエストは、テキスト入力を受け取り、場所を返します。入力には、名前、住所、電話番号など、あらゆる種類の Places テキストデータを使用できます。リクエストは文字列にする必要があります。緯度/経度座標や Plus Code などの文字列以外のデータを使用した Find Place（従来版）リクエストは、エラーになります。

Find Place（従来版）リクエスト

Find Place（従来版）リクエストは、次の形式の HTTP URL です。

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

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

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

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

必須パラメータ

• 入力

  検索するテキスト文字列。地名、住所、電話番号のいずれかを入力する必要があります（例: 「123 Main Street」、「City Hall」）。

• inputtype

  入力のタイプ。textquery または phonenumber のいずれかになります。電話番号は、国際電話形式（先頭にプラス記号（+）、国コード、電話番号の順）にする必要があります。詳しくは、ITU 勧告 E.164 を参照してください。

オプション パラメータ

• fields

  注: Place Search（従来版）リクエストと Place Details（従来版）リクエストで、同じフィールドが返されることはありません。Place Search（従来版）リクエストでは、Place Details（従来版）リクエストで返されるフィールドのサブセットが返されます。目的のフィールドが Place Search（従来版）で返されない場合は、Place Search（従来版）を使用して place_id を取得してから、そのプレイス ID を使用して Place Details（従来版）リクエストを実行します。Place Search（従来版）リクエストで使用できないフィールドの詳細については、Places API のフィールド サポートをご覧ください。

  fields パラメータを使用して、返す場所データのタイプのカンマ区切りのリストを指定します。例: fields=formatted_address,name,geometry。複合的な値を指定する場合はスラッシュを使用します。例: opening_hours/open_now。

  フィールドは、Basic、Contact、Atmosphere の 3 つの請求カテゴリに分けられます。Basic フィールドは基本レートで課金され、Contact フィールドと Atmosphere フィールドはより高いレートで課金されます。Basic、Contact、Atmosphere の各 SKU は、それらをトリガーしたリクエストのベース SKU（Place Details、Find Place、Nearby Search、テキスト検索）に加えて課金されます。詳細については、価格表をご覧ください。

  Basic

  Basic カテゴリには次のフィールドが含まれます。 address_components、adr_address、 business_status、formatted_address、 geometry、icon、icon_mask_base_uri、 icon_background_color、name、 permanently_closed（サポート終了）、photo、place_id、plus_code、 type、url、utc_offset、 vicinity、wheelchair_accessible_entrance。

  連絡先

  Contact カテゴリには、次のフィールドがあります。 current_opening_hours、formatted_phone_number、 international_phone_number、opening_hours、 secondary_opening_hours、website

  Atmosphere

  Atmosphere カテゴリには、次のフィールドが含まれます。 curbside_pickup、delivery、dine_in、 editorial_summary、price_level、 rating、reservable、reviews、 serves_beer、serves_breakfast、 serves_brunch、serves_dinner、 serves_lunch、serves_vegetarian_food、 serves_wine、takeout、 user_ratings_total。

  注: アトリビューション（html_attributions）は、このフィールドがリクエストされているかどうかにかかわらず、呼び出しのたびに必ず返されます。

• 言語

  結果を返す言語。

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

• locationbias

  半径と緯度/経度、または長方形の点を表す 2 つの緯度/経度のペアを指定して、指定したエリアの結果を優先します。このパラメータが指定されていない場合、API はデフォルトで IP アドレス バイアスを使用します。

  • IP バイアス: IP アドレス バイアスを使用するよう API に指示します。文字列 ipbias を渡します（このオプションには追加のパラメータはありません）。
  • 円形: 半径（メートル単位）と緯度/経度（10 進数）を指定する文字列。形式は次のようにします: circle:radius@lat,lng。
  • 矩形: 矩形の南西と北東のポイントを表す、緯度と経度のペアを 10 進数で 2 つ指定する文字列。rectangle:south,west|north,east の形式を使用します。なお、東西の値は -180 ～ 180 の範囲にラップされ、南北の値は -90 ～ 90 の範囲にクランプされます。

Find Place（従来版）の例

次の例は、「Museum of Contemporary Art Australia」の Find Place（従来版）リクエストを示しています。このリクエストには、photos、formatted_address、name、rating、opening_hours、geometry フィールドが含まれています。

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

次の例は、「Mongolian Grill」を検索する Find Place（従来版）リクエストです。locationbias パラメータを使用して、指定した座標から 2,000 m 以内の結果を優先的に表示します。

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

次の例は、電話番号の Find Place（従来版）リクエストを示しています。このリクエストが準拠 URL になるように、国際電話のプレフィックス「+」が %2B にエンコードされていることに注意してください。エンコードされていない場合、+ プレフィックスはサーバー上でスペースにデコードされ、無効な電話番号の検索になります。

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Find Place（従来版）のレスポンス

Find Place（従来版）のレスポンスには、fields パラメータを使用して指定されたデータタイプと html_attributions のみが含まれます。次の例は、「Museum of Contemporary Art Australia」の Find Place（従来版）リクエストに対するレスポンスを示しています。formatted_address、geometry、name、opening_hours、photos、rating フィールドが含まれています。

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

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（従来版）リクエストで渡します。エンドポイント全体のフィールドの可用性と料金階層については、プレイスデータ フィールド（レガシー）をご覧ください。