Nearby Search（新機能）への移行

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

はじめに

Places API は Nearby Search（従来版）をサポートしています。Nearby Search（従来版）に慣れている場合、Nearby Search（新版）では次の変更が行われます。

  • Nearby Search（新版）は HTTP POST リクエストを使用します。 HTTP POST リクエストの一部として、リクエスト本文またはヘッダーでパラメータを渡します。一方、Nearby Search（従来版）では、HTTP GET リクエストを使用して URL パラメータを渡します。
  • フィールドのマスキングが必要です。レスポンスで返すフィールドを指定する必要があります。返されるフィールドのデフォルト リストはありません。このリストを省略すると、メソッドはエラーを返します。詳細については、FieldMask をご覧ください。
  • Nearby Search（新版）では、認証メカニズムとして API キーと OAuth トークンの両方がサポートされています。
  • Nearby Search（新版）のレスポンス形式としてサポートされているのは JSON のみです。
  • 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