Package google.maps.geocode.v4alpha

インデックス

DestinationService

宛先を取得するためのサービス。

目的地は、場所に関する階層的なコンテキストを提供します。これにより、たとえば、大規模なアパート群の中にあるアパートの建物を探したり、その逆の操作を行ったりできます。また、ライドシェアや配達などのユースケースに適したナビゲーション ポイントも提供します。

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

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

認可スコープ

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

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

目的地

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

フィールド
primary

PlaceView

リクエストの primary_query で特定されたプライマリ プレイス。
containing_places[]

PlaceView

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

PlaceView

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

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

Landmark

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

Entrance

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

NavigationPoint

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

入口

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

フィールド
location

LatLng

入り口の場所。
tags[]

Entrance.Tag

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

string

この入口が物理的に配置されている構造物（places/{place_id} 形式）。

タグ

入り口を表す特性。

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

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

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

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

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

ランドマーク

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

フィールド
tags[]

Landmark.Tag

ランドマークをデスティネーションのコンテキストで使用する方法を説明するタグ。
共用体フィールド landmark。ランドマーク。landmark は次のいずれかになります。
place

PlaceView

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

タグ

目的地というコンテキストでランドマークをどのように使用できるかを説明する、考えられるすべてのタグのリスト。

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

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

ナビゲーション ポイントは、ナビゲーションの終点となる道路の近くの場所です。

フィールド
display_name

LocalizedText

このナビゲーション ポイントの表示名。（例: 「5th Ave」、「Gate B」）。
location

LatLng

ナビゲーションの終了地点として適切な道路セグメントの横のポイント。このポイントは、道路の中心線から意図的にわずかにずらして、場所がある道路の側を明確に示しています。
travel_modes[]

NavigationPoint.TravelMode

このナビゲーション ポイントに適した移動手段。
usages[]

NavigationPoint.Usage

このナビゲーション ポイントでサポートされている使用方法。

TravelMode

このナビゲーション ポイントに適した移動手段。

列挙型
TRAVEL_MODE_UNSPECIFIED 使用されません。
DRIVE 運転に適しています。
WALK ウォーキングに適しています。

用途

このナビゲーション ポイントでサポートされている使用方法。

列挙型
USAGE_UNSPECIFIED 使用されません。
UNKNOWN 不明な使用タイプ。ほとんどのナビゲーション ポイントは UNKNOWN になりますが、必ずしも使用が制限されるわけではありません。このナビゲーションは、乗車場所や降車場所に適している可能性があります。
DROPOFF 乗客の降車に適しています。たとえば、ライドシェアの降車場所などです。
PICKUP 乗客の乗降に適しています。たとえば、ライドシェアの乗車場所などです。

PlaceView

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

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

フィールド
place

string

このプレイスのリソース名（places/{placeId} 形式）。
display_name

LocalizedText

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

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 をご覧ください。
formatted_address

string

1 行の住所。
postal_address

PostalAddress

構造化された住所。
structure_type

PlaceView.StructureType

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

LatLng

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

Struct

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

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

StructureType

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

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

SearchDestinationsRequest

DestinationService.SearchDestinations に対するリクエスト メッセージ。

フィールド
travel_modes[]

NavigationPoint.TravelMode

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

string

省略可。結果を返す言語。
region_code

string

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

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

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

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

string

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

SearchDestinationsRequest.AddressQuery

番地です。
location_query

SearchDestinationsRequest.LocationQuery

正確な位置情報。

AddressQuery

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

フィールド
共用体フィールド kind。アドレス クエリ。kind は次のいずれかになります。
address

PostalAddress

郵便住所形式の番地。
address_query

string

1 行で表された番地。

LocationQuery

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

注: 位置情報のクエリが、サブプレミスを含む建物内にある場合、返されるプライマリ プレイスがサブプレミスである可能性があります。このような場合、containing_places フィールドには建物が含まれます。

フィールド
共用体フィールド kind。位置情報クエリ。kind は次のいずれかになります。
location

LatLng

正確な LatLng の位置。

SearchDestinationsResponse

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

フィールド
destinations[]

Destination

宛先のリスト。

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