Nearby Search（新機能）への移行

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

はじめに

Places API は Nearby Search（Legacy）をサポートしています。Nearby Search（以前のバージョン）をご利用の場合は、 Nearby Search（新版）で次の変更が行われます。

  • Nearby Search（新版）は HTTP POST リクエストを使用します。HTTP POST リクエストの一部として、リクエスト本文またはヘッダーでパラメータを渡します。一方、Nearby Search（レガシー）では、HTTP GET リクエストを使用して URL パラメータを渡します。
  • フィールドのマスキングが必要です。レスポンスで返すフィールドを指定する必要があります。返されるフィールドのデフォルトのリストはありません。このリストを省略すると、メソッドはエラーを返します。詳細については、FieldMask をご覧ください。
  • Nearby Search（新版）では、認証メカニズムとして API キーと OAuth トークンの両方がサポートされています。
  • Nearby Search（新版）では、レスポンス形式として JSON のみがサポートされています。
  • テキスト クエリを含むすべてのリクエストで、Text Search（新版）を使用する必要があります。Nearby Search（新版）ではテキスト入力がサポートされていないためです。
  • Nearby Search（新版）の JSON レスポンス形式は、以前の API の形式から変更されています。詳しくは、Places API レスポンスを移行するをご覧ください。

次の表に、Nearby Search（レガシー）で名前が変更されたか、Nearby Search（新しい）で変更されたパラメータ、またはサポートされなくなったパラメータを示します。

現在のパラメータ 新しいパラメータ メモ
keyword サポートされていません。代わりにテキスト検索（新版）を使用してください。
language languageCode
location locationRestriction 必須。
maxprice/minprice サポートされていません。
maxResultCount 新しいパラメータ。
opennow サポートされていません。
pagetoken サポートされていません。
radius locationRestriction を今すぐ利用します。
rankby rankPreference
regionCode 新しいパラメータ。
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		新しいパラメータも複数の型値を受け入れます。以前の API は単一の値のみを受け入れます。

リクエスト例

次の GET リクエストの例では、Nearby Search（レガシー）を使用しています。この例では、タイプ restaurant の場所に関する情報を含む JSON レスポンスをリクエストし、すべてのパラメータを URL パラメータとして渡します。

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

Nearby Search（新版）では、POST リクエストを行い、すべてのパラメータを JSON リクエスト本文またはヘッダーで POST リクエストの一部として渡します。この例では、フィールド マスクも使用しているため、レスポンスには場所の表示名とフォーマット済み住所のみが含まれます。

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby