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
  },
  "addressComponents": [
    {
      object (PlaceView.AddressComponent)
    }
  ]
}
フィールド
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 オブジェクトで複数のポリゴンを表すことができます。
addressComponents[]

object (PlaceView.AddressComponent)

地域レベルごとに繰り返されるコンポーネント。

PlaceView.AddressComponent

書式設定された住所を構成する構造化コンポーネント（この情報が利用可能な場合）。

JSON 表現 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
フィールド
longText

string

住所コンポーネントの説明または名前。たとえば、オーストラリアの住所コンポーネントの場合、長い名前は「オーストラリア」になります。
shortText

string

住所コンポーネントの略称（略称がある場合）。たとえば、オーストラリアの住所コンポーネントの略称は「AU」になります。
types[]

string

住所コンポーネントのタイプを示す配列。

詳しくは、https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types をご覧ください。
languageCode

string

このコンポーネントのフォーマットに使用される言語（CLDR 表記）。

ランドマーク

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

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 の Address Descriptors 機能によって返されるランドマークに似ています（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

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

integer

出力サムネイル画像の高さ（ピクセル単位）。注: サムネイルとともにアノテーションをリクエストする場合は、アノテーションの座標が画像と正しく一致するように、Street View 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)

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