Method: geocode.destinations.searchDestinations

このメソッドは、宛先ルックアップを実行し、宛先のリストを返します。

HTTP リクエスト

POST https://geocode.googleapis.com/v4alpha/geocode/destinations

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "travelModes": [
    enum (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
フィールド
travelModes[]

enum (NavigationPoint.TravelMode)

省略可。ナビゲーション ポイントをフィルタする交通手段。これは、レスポンスで返される navigationPoints フィールドに影響します。空の場合、すべての交通手段のナビゲーション ポイントが返されます。
languageCode

string

省略可。結果が返される言語。
regionCode

string

省略可。地域コード。ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定される地域コード。このパラメータは、適用される法律に基づいて結果に影響します。このパラメータは、サービスから返される結果に影響を与えますが、完全に制限するわけではありません。

共用体フィールド primary_query。プライマリ デスティネーションのクエリを実行します。場所、完全修飾の住所、LatLng のいずれかを指定できます。情報が少ない場所や住所は、目的地に設定できない場合があります。

宛先は、指定されたプライマリ クエリを中心に構築されます。

注: ナビゲーションの目的地に設定できる場所と住所のみがサポートされます。たとえば、一軒家やアパート・マンションを表す場所はプライマリ クエリとして使用できますが、地域区分や行政区域を表す場所はプライマリ クエリとして使用できません。primary_query は次のいずれかになります。
place

string

場所のリソース名（places/{placeId} 形式）。
addressQuery

object (SearchDestinationsRequest.AddressQuery)

番地です。
locationQuery

object (SearchDestinationsRequest.LocationQuery)

正確な位置情報。

レスポンスの本文

DestinationService.SearchDestinations に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
フィールド
destinations[]

object (Destination)

宛先のリスト。

プライマリ クエリからプライマリ デスティネーションを一意に特定できる場合、サービスは 1 つの結果を返します。そうしないと、サービスは曖昧さ回避のために複数の結果を返すか、結果を返さない可能性があります。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.destinations

SearchDestinationsRequest.AddressQuery

検索する番地。対象国の郵便業務で使用されている形式で住所を指定します。

JSON 表現 
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。アドレス クエリ。kind は次のいずれかになります。
address

object (PostalAddress)

郵便番号形式の番地。
addressQuery

string

1 行で表された番地。

SearchDestinationsRequest.LocationQuery

付近の主な目的地を特定するための位置情報クエリ。

注: 位置情報クエリが、サブ施設を含む建物内にある場合、返されるメインの場所がサブ施設である可能性があります。この場合、containingPlaces フィールドに建物が含まれます。

JSON 表現 
{
  "placeFilter": {
    object (SearchDestinationsRequest.LocationQuery.PlaceFilter)
  },

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
フィールド
placeFilter

object (SearchDestinationsRequest.LocationQuery.PlaceFilter)

省略可。宛先候補に適用するフィルタ。
共用体フィールド kind。位置情報クエリ。kind は次のいずれかになります。
location

object (LatLng)

正確な LatLng の位置。

SearchDestinationsRequest.LocationQuery.PlaceFilter

宛先候補に適用するフィルタ。

JSON 表現 
{
  "structureType": enum (PlaceView.StructureType),
  "addressability": enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)
}
フィールド
structureType

enum (PlaceView.StructureType)

省略可。指定すると、すべてのデスティネーションにこの構造タイプのプライマリ プレイスが必ず存在します。これにより、一部の目的地が除外されたり、返される目的地が粗くなったり、絞り込まれたりすることがあります。

たとえば、GROUNDS が指定されている場合、返されるすべての目的地には GROUNDS 構造タイプのプライマリ プレイスがあります。これにより、根拠の一部ではない目的地が除外されたり、返される目的地が根拠レベルに粗くされたりする可能性があります。

このフィールドのもう 1 つの用途は、建物の表示ポリゴンを簡単に抽出することです。たとえば、BUILDING が指定されている場合、メインの場所の表示ポリゴンは指定された場所にある建物になります。
addressability

enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)

省略可。指定した場合、対応するアドレス指定の条件を満たすデスティネーションのみが返されます。

PlaceView.StructureType

この場所が表す構造物のタイプ。

列挙型
STRUCTURE_TYPE_UNSPECIFIED 使用されません。
POINT ポイントの場所。
SECTION 建物の一部分。
BUILDING 建物。
GROUNDS 通常、大学のキャンパス、アパートの複合施設、ショッピング モールなど、複数の建物を含む広いエリア。

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

アドレス指定可能性フィルタリングのオプションを定義します。今後、新しい値が追加される可能性があります。

列挙型
ADDRESSABILITY_UNSPECIFIED 指定しない場合、サービスは適切なデフォルトを選択します。
ANY アドレス指定可能性はフィルタリング条件ではありません。宛先は、アドレス指定可能性に関係なく返されます。
PRIMARY 返されるすべての目的地には、番地または名前を含むメインの場所があります。
WEAK 返されるすべての目的地には、番地または名前を含むメインの場所またはサブ目的地があります。

目的地

目的地。これには、メインの場所、関連する場所、入り口、ナビゲーション ポイントが含まれます。

JSON 表現 
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "parkingOptions": {
    object (Destination.ParkingOptions)
  },
  "arrivalSummary": {
    object (Destination.ArrivalSummary)
  }
}
フィールド
primary

object (PlaceView)

リクエストの primary_query で識別されるプライマリ プレイス。
containingPlaces[]

object (PlaceView)

メインの場所が包含される、より精度が低い場所。たとえば、この建物を含むアパートの複合施設などです。
subDestinations[]

object (PlaceView)

メインの場所のより正確なサブ目的地。たとえば、建物内のユニットなどです。

注: このサブ目的地リストは、Places API から返される SubDestination と比較して、より包括的であり、各サブ目的地にはより多くの情報が含まれています。
landmarks[]

object (Landmark)

目的地を伝えるため、または到着をサポートするために使用できるランドマーク。
entrances[]

object (Entrance)

この目的地の入り口。
navigationPoints[]

object (NavigationPoint)

この目的地のナビゲーション ポイント。
parkingOptions

object (Destination.ParkingOptions)

この目的地の駐車場オプション。
arrivalSummary

object (Destination.ArrivalSummary)

目的地の到着体験に関する AI 生成の概要。

PlaceView

Places API の Place のビューを表します。また、構造タイプや表示ポリゴンなど、目的地に固有の追加情報も提供します。

場合によっては、同じプレイス ID の PlaceView が、Places API から types フィールドと displayName フィールドに対して返されるものと異なることがあります。

JSON 表現 
{
  "place": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  }
}
フィールド
place

string

この場所のリソース名（places/{placeId} 形式）。場所の検索に使用できます。
placeId

string

場所の一意の識別子。
displayName

object (LocalizedText)

人が読める形式の場所の説明。例: 「B ゲート」、「マクドナルド」
primaryType

string

このスポットのプライマリ スポットタイプ。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。

注: このフィールドには常に値が入力されるわけではありません。このような状況では、types フィールドを使用する準備をしてください。
types[]

string

このスポットに関連付けられているすべてのスポットタイプ。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。
formattedAddress

string

1 行の住所。
postalAddress

object (PostalAddress)

構造化された住所。
structureType

enum (PlaceView.StructureType)

このスポットに対応する構造のタイプ。
location

object (LatLng)

この場所の所在地。ポリゴンが表示される場所の場合、これは地図上にマーカーを配置するのに適した場所を表す可能性があります。
displayPolygon

object (Struct format)

RFC 7946 形式（https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6）を使用した、GeoJSON 形式の場所のポリゴン アウトライン。

注: RFC 7946 形式は MultiPolygon をサポートしているため、1 つの displayPolygon オブジェクトで複数のポリゴンを表すことができます。

ランドマーク

ランドマークは、目的地がどこにあるかを伝えたり、目的地に到着するのを手助けしたりするために使用されます。

JSON 表現 
{
  "relationalDescription": {
    object (LocalizedText)
  },
  "tags": [
    enum (Landmark.Tag)
  ],
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number,

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
フィールド
relationalDescription

object (LocalizedText)

目的地とランドマークの関係を説明する、人が読める形式の説明。（例: 「エンパイア ステート ビルディングの近く」、「ホワイトハウスの向かい」）。
tags[]

enum (Landmark.Tag)

ランドマークをデスティネーションのコンテキストで使用する方法を説明するタグ。
straightLineDistanceMeters

number

出力専用。このランドマークから目的地までの直線距離（メートル単位）。
travelDistanceMeters

number

出力専用。このランドマークから目的地までの道路網の距離（メートル単位）。
共用体フィールド landmark。ランドマーク。landmark は次のいずれかになります。
place

object (PlaceView)

このランドマークを表す場所。

Landmark.Tag

ランドマークが目的地に関連してどのように使用されるかを説明する、考えられるすべてのタグのリスト。

住所に ADDRESS タグと ARRIVAL タグの両方が付いている場合、そのランドマークはローカルで目立っていて、目的地にも近いことを意味します。

列挙型
TAG_UNSPECIFIED 使用されません。
ADDRESS 目的地のおおよその現在地を特定するために使用できる、地域でよく知られている場所。通常は目的地から数百メートル以内です。これらは、Geocoding API の住所記述子機能によって返されるランドマーク（https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors）に似ています。
ARRIVAL 目的地への到着をサポートするために使用できる場所。目的地に近づいたときにナビゲーションに役立ちます。たとえば、このランドマークは目的地から道路を挟んだ場所にある可能性があります。このタグが付いたランドマークは、通常、ADDRESS タグが付いたランドマークよりも目的地に近い場所にあります。

入口

エントランスは、場所の出入り口の位置を定義する単一の緯度/経度座標ペアです。

JSON 表現 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string,
  "streetViewThumbnail": {
    object (StreetViewThumbnail)
  },
  "streetViewAnnotation": {
    object (ImageAnnotation)
  }
}
フィールド
location

object (LatLng)

入り口の場所。
tags[]

enum (Entrance.Tag)

入り口を説明するタグのリスト。
place

string

この入り口が物理的に存在する構造物（places/{placeId} 形式）。
streetViewThumbnail

object (StreetViewThumbnail)

入り口を示すストリートビューのサムネイル画像。この画像はストリートビュー Static API からリクエストできます。https://developers.google.com/maps/documentation/streetview/request-streetview をご覧ください。
streetViewAnnotation

object (ImageAnnotation)

上記で返された streetViewThumbnail のエントランスのアノテーション。

Entrance.Tag

入り口を表す特性。

列挙型
TAG_UNSPECIFIED 使用されません。
PREFERRED

このエントランスは、返された目的地内の主要な場所への物理的なアクセスを提供している可能性があります。1 つのスポットに複数の推奨入り口を設定できます。このタグがない場合、入り口はメインの場所と同じ建物内にありますが、必ずしもその場所へのアクセスを提供しているとは限りません。

たとえば、プライマリ プレイスが商店街のレストランの場合、「優先」エントランスはレストラン自体につながる可能性の高いエントランスになり、返される他のエントランスは、商店街の他のレストランのエントランスなど、建物の他のエントランスになります。

主要な場所が建物自体である場合、PREFERRED の入り口は建物の「メイン」部分につながる入り口になります。たとえば、ショッピング センターでは、メインのホワイエ エリアにアクセスできる入り口が PREFERRED の入り口になります。ただし、建物の側面にあるストアにのみアクセスできる入り口は、PREFERRED の入り口にはなりません。

注: PREFERRED の入り口からメインの場所に入れない場合もあれば、PREFERRED 以外の入り口からメインの場所に入れる場合もあります。

StreetViewThumbnail

Google ストリートビューのサムネイルを表すパラメータ。これらのパラメータは、Street View Static API からストリートビュー画像をリクエストするために使用できます。https://developers.google.com/maps/documentation/streetview/request-streetview をご覧ください。

JSON 表現 
{
  "pano": string,
  "widthPx": integer,
  "heightPx": integer,
  "headingDegree": number,
  "pitchDegree": number,
  "fovDegree": number
}
フィールド
pano

string

特定のパノラマ ID。
widthPx

integer

出力サムネイル画像の幅（ピクセル単位）。注: サムネイルとともにアノテーションをリクエストする場合は、アノテーションの座標が画像と正しく一致するように、ストリートビュー API リクエストでこれらの高さと幅の値を使用する必要があります。
heightPx

integer

出力サムネイル画像の高さ（ピクセル単位）。注: サムネイルとともにアノテーションをリクエストする場合は、アノテーションの座標が画像と正しく一致するように、ストリートビュー API リクエストでこれらの高さと幅の値を使用する必要があります。
headingDegree

number

カメラの水平方向の向き（度単位）。範囲は [0, 360) です。0 は北、90 は東を意味します。
pitchDegree

number

カメラの垂直方向の向き（度単位）。範囲は [-90, 90] です。0 は水平、+90 は真上、-90 は真下です。
fovDegree

number

水平画角（度）。範囲は (0, 180] です。ズームレベルを制御します。FOV が小さいほど、ズーム率が高くなります。

ImageAnnotation

画像のサムネイルに対するアノテーション（入り口を囲むポリゴンなど）。

JSON 表現 
{
  "coordinates": [
    {
      object (ImageAnnotation.Coordinate)
    }
  ]
}
フィールド
coordinates[]

object (ImageAnnotation.Coordinate)

画像上のポリゴンを形成する座標のリスト。座標は反時計回りの順序で指定します。

ImageAnnotation.Coordinate

画像上の点のピクセル座標。原点（0,0）は画像の左上隅のピクセルの左上隅で、x 軸は右方向、y 軸は下方向を指します。

JSON 表現 
{
  "xPx": number,
  "yPx": number
}
フィールド
xPx

number

X 座標。
yPx

number

Y 座標。

Destination.ParkingOptions

目的地の駐車オプションに関する情報。

JSON 表現 
{
  "availability": enum (Destination.ParkingOptions.Availability),
  "onsiteParking": boolean,
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
フィールド
availability

enum (Destination.ParkingOptions.Availability)

この目的地で利用可能な駐車場の有無。
onsiteParking

boolean

目的地に駐車場がある。
freeParkingLot

boolean

無料駐車場あり。
paidParkingLot

boolean

有料駐車場あり。
freeStreetParking

boolean

無料の路上駐車スペースあり。
paidStreetParking

boolean

有料の路上駐車スペースあり。
valetParking

boolean

係員による駐車サービスあり。
freeGarageParking

boolean

屋内駐車場を無料で利用可能。
paidGarageParking

boolean

有料の屋内駐車場あり。

Destination.ParkingOptions.Availability

この場所を訪れたときに駐車場を見つけるのがどれほど難しいかを総合的に評価した指標。

今後、新しい値が追加される可能性があります。

列挙型
AVAILABILITY_UNSPECIFIED 駐車場の空き状況は確認できません。
PLENTY 駐車場は十分にあります。
SOMEWHAT_DIFFICULT 駐車場がやや見つけにくい。
DIFFICULT 駐車場が非常に見つけにくい。

Destination.ArrivalSummary

目的地の到着体験に関する AI 生成の概要。

JSON 表現 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUrl": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
フィールド
text

object (LocalizedText)

目的地での到着体験の概要。
flagContentUrl

string

ユーザーが要約に関する問題を報告できるリンク。
disclosureText

object (LocalizedText)

出力専用。到着概要の開示テキストが含まれます。