インデックス
DestinationService(インターフェース)GeocodeService(インターフェース)Destination(メッセージ)Destination.ArrivalSummary(メッセージ)Destination.ParkingOptions(メッセージ)Destination.ParkingOptions.Availability(列挙型)Destination.ParkingOptions.ParkingFacility(メッセージ)Entrance(メッセージ)Entrance.Tag(列挙型)GeocodeAddressRequest(メッセージ)GeocodeAddressRequest.LocationBias(メッセージ)GeocodeAddressResponse(メッセージ)GeocodeLocationRequest(メッセージ)GeocodeLocationResponse(メッセージ)GeocodePlaceRequest(メッセージ)GeocodeResult(メッセージ)GeocodeResult.AddressComponent(メッセージ)GeocodeResult.Granularity(列挙型)ImageAnnotation(メッセージ)ImageAnnotation.Coordinate(メッセージ)Landmark(メッセージ)Landmark.Tag(列挙型)NavigationPoint(メッセージ)NavigationPoint.TravelMode(列挙型)NavigationPoint.Usage(列挙型)PlaceView(メッセージ)PlaceView.AddressComponent(メッセージ)PlaceView.StructureType(列挙型)PlusCode(メッセージ)SearchDestinationsRequest(メッセージ)SearchDestinationsRequest.AddressQuery(メッセージ)SearchDestinationsRequest.LocationQuery(メッセージ)SearchDestinationsRequest.LocationQuery.PlaceFilter(メッセージ)SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability(列挙型)SearchDestinationsResponse(メッセージ)StreetViewThumbnail(メッセージ)
DestinationService
目的地を取得するためのサービス。
目的地は、場所に関する階層的なコンテキストを提供します。これにより、たとえば、大規模なアパート・マンション複合施設内のアパート・マンションの建物を見つけることができます。また、その逆も可能です。また、ライドシェアや配達などのユースケースに適したナビゲーション ポイントも提供します。
| SearchDestinations |
|---|
|
このメソッドは、宛先の検索を実行し、宛先のリストを返します。
|
GeocodeService
ジオコーディングを実行するためのサービス。
| GeocodeAddress |
|---|
|
このメソッドは、住所を LatLng にマッピングする住所ジオコーディングを実行します。また、住所に関する構造化された情報も提供します。
|
| GeocodeLocation |
|---|
|
このメソッドは、LatLng を住所にマッピングする位置情報のジオコーディングを実行します。また、住所に関する構造化された情報も提供します。
|
| GeocodePlace |
|---|
|
このメソッドは、プレイス ID を使用してジオコード検索を実行します。
|
宛先
目的地。これには、メインの場所、関連する場所、入り口、ナビゲーション ポイントが含まれます。
| フィールド | |
|---|---|
primary |
リクエストの |
containing_places[] |
プライマリの場所が含まれる、より大まかな場所。たとえば、この建物を含むアパート・マンションなどです。 |
sub_destinations[] |
メインの場所のより詳細なサブ目的地。たとえば、建物に含まれるユニットなどです。 注: Places API から返される SubDestination と比較すると、このサブ目的地のリストはより網羅的で、各サブ目的地にはより多くの情報が含まれています。 |
landmarks[] |
目的地の場所を伝えたり、到着をサポートしたりするために使用できるランドマーク。 |
entrances[] |
この目的地の入り口。 |
navigation_points[] |
この目的地のナビゲーション ポイント。 |
parking_options |
この目的地の駐車オプション。 |
arrival_summary |
目的地への到着時の状況に関する AI 生成の要約。 |
ArrivalSummary
目的地への到着時の状況に関する AI 生成の要約。
| フィールド | |
|---|---|
text |
目的地への到着時のエクスペリエンスの概要。 |
flag_content_url |
要約の問題を報告できるリンク。 |
disclosure_text |
出力専用。到着概要の開示テキストが含まれます。 |
ParkingOptions
目的地付近の駐車方法に関する情報。
| フィールド | |
|---|---|
availability |
この目的地での駐車場の利用可能性。 |
parking_facilities[] |
この目的地の駐車場。 |
onsite_parking |
目的地に敷地内駐車場がある。 |
free_parking_lot |
無料駐車場あり。 |
paid_parking_lot |
有料駐車場を提供している。 |
free_street_parking |
無料の路上駐車スペースあり。 |
paid_street_parking |
有料の路上駐車スペースがあります。 |
valet_parking |
バレー パーキングを提供している。 |
free_garage_parking |
無料の屋内駐車スペースあり。 |
paid_garage_parking |
有料の屋内駐車スペースを提供しています。 |
対象
この場所を訪れる際に駐車スペースを見つけるのがどの程度難しいかを示す集計指標。
今後、新しい値が追加される可能性があります。
| 列挙型 | |
|---|---|
AVAILABILITY_UNSPECIFIED |
駐車場の空き状況は利用できません。 |
PLENTY |
駐車場は十分にあります。 |
SOMEWHAT_DIFFICULT |
駐車場がやや見つけにくい。 |
DIFFICULT |
駐車場が非常に見つけにくい。 |
ParkingFacility
目的地に関連付けられた、個別の駐車オプション(特定の屋内駐車場や駐車場など)。これは、特定の駐車施設に関する詳細情報を提供します。一方、親の ParkingOptions メッセージは、利用可能なすべての駐車場の集計概要を提供します。
| フィールド | |
|---|---|
place |
この特定の駐車施設の場所表現。 |
onsite |
この駐車場が主な目的地の敷地内にあるかどうか。このフィールドが設定されていない場合、オンサイト ステータスは不明です。 |
popular |
この駐車場が、主な目的地に移動する訪問者に人気があるかどうか。このフィールドが設定されていない場合、人気度は不明です。 |
straight_line_distance_meters |
主な目的地からこの駐車場までの直線距離(メートル単位)。 |
入口
エントランスは、場所の出入り口の位置を定義する緯度と経度の座標ペアです。
| フィールド | |
|---|---|
display_name |
人が読める形式の名前(例: 「ゲート B」、「南口」、「5 番街入口」)。 |
location |
入口の場所。 |
tags[] |
入り口を説明するタグのリスト。 |
place |
この入口が物理的に配置されている構造( |
street_view_thumbnail |
入口を示すストリートビューのサムネイル画像。画像はストリートビュー Static API からリクエストできます。https://developers.google.com/maps/documentation/streetview/request-streetview をご覧ください。 |
street_view_annotation |
上記で返された |
タグ
入り口を説明する特性。
| 列挙型 | |
|---|---|
TAG_UNSPECIFIED |
使用されません。 |
PREFERRED |
このエントランスは、返された目的地の主要な場所への物理的なアクセスを提供している可能性があります。1 つの場所に複数の優先エントランスを設定できます。このタグが付いていない入口は、物理的にはメインの場所と同じ建物にありますが、必ずしもその場所へのアクセスを提供するわけではありません。 たとえば、メインの場所がストリップ モール内のレストランの場合、「PREFERRED」エントランスはレストラン自体に通じるエントランスになります。返される他のエントランスは、ストリップ モール内の他のレストランへのエントランスなど、建物の他のエントランスになります。 メインの場所が建物自体である場合、 注: |
GeocodeAddressRequest
GeocodeService.GeocodeAddress のリクエスト メッセージ。
| フィールド | |
|---|---|
location_bias |
省略可。検索するリージョン。この位置情報はバイアスとして機能します。つまり、指定された位置情報の周辺の結果が優先されます。 |
language_code |
省略可。結果を返す言語。 |
region_code |
省略可。地域コード。地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。このパラメータは、適用される法律に基づいて結果に影響します。このパラメータは、サービスから返される結果に影響を与えますが、完全に制限するわけではありません。 |
共用体フィールド address_input。ジオコーディングする住所。address_input は次のいずれかになります。 |
|
address_query |
ジオコーディングする非構造化住所。 |
address |
ジオコーディングする構造化された住所(郵送先住所形式)。 |
LocationBias
検索するリージョン。この位置情報はバイアスとして機能します。つまり、指定された位置情報の周辺の結果が優先されます。
| フィールド | |
|---|---|
共用体フィールド type。位置情報のバイアスの種類。type は次のいずれかになります。 |
|
rectangle |
北東と南西の角で定義される長方形のボックス。 |
GeocodeAddressResponse
GeocodeService.GeocodeAddress に対するレスポンス メッセージです。
| フィールド | |
|---|---|
results[] |
ジオコーディングの結果。 |
GeocodeLocationRequest
GeocodeService.GeocodeLocation のリクエスト メッセージ。
| フィールド | |
|---|---|
language_code |
省略可。結果を返す言語。 |
region_code |
省略可。地域コード。地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。このパラメータは、適用される法律に基づいて結果に影響します。 |
types[] |
省略可。結果を制限するタイプタグのセット。指定したタイプのいずれにも該当しない結果は削除されます。 指定できる値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。 |
granularity[] |
省略可。1 つ以上の場所の粒度列挙型のフィルタ。 |
共用体フィールド location_input。ジオコーディングする場所。location_input は次のいずれかになります。 |
|
location_query |
「lat,lng」文字列形式の場所。例: 「64.7611872,-18.4705364」 |
location |
構造化形式の場所。 |
GeocodeLocationResponse
GeocodeService.GeocodeLocation に対するレスポンス メッセージです。
| フィールド | |
|---|---|
results[] |
ジオコーディングの結果。 |
plus_code |
リクエスト内の場所の Plus Code。 |
GeocodePlaceRequest
GeocodeService.GeocodePlace のリクエスト メッセージ。
| フィールド | |
|---|---|
place |
必須。ジオコーディングする場所の識別子。places/{place} の形式で指定します。 |
language_code |
省略可。結果を返す言語。 |
region_code |
省略可。地域コード。地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。このパラメータは、適用される法律に基づいて結果に影響します。 |
GeocodeResult
ジオコーディングの結果には、場所に関する地理情報が含まれます。
| フィールド | |
|---|---|
place |
この Place のリソース名( |
place_id |
場所の固有識別子。 |
location |
この住所の緯度と経度。 |
granularity |
場所の粒度。 |
viewport |
ジオコーディングの結果を表示するのに適したビューポート。 |
bounds |
住所の境界ボックス。 |
formatted_address |
1 行形式の住所。 |
postal_address |
住所(郵便番号形式)。 |
address_components[] |
各地域レベルの繰り返しコンポーネント。 |
postal_code_localities[] |
郵便番号に含まれる地域区分の完全なリスト。 このフィールドは、結果のタイプが「postal_code」の場合にのみ入力されます。 |
types[] |
この結果のタイプタグのセット。(例: 「political」と「administrative_area」)。 指定できる値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。 |
plus_code |
このジオコード内の場所の Plus Code。 |
AddressComponent
フォーマットされた住所を構成する構造化コンポーネント(この情報が利用可能な場合)。
| フィールド | |
|---|---|
long_text |
住所コンポーネントの説明または名前。たとえば、オーストラリアの住所コンポーネントの場合、正式名称は「Australia」になります。 |
short_text |
住所コンポーネントの略称(略称がある場合)。たとえば、オーストラリアの住所コンポーネントの場合、略称は「AU」になります。 |
types[] |
住所コンポーネントのタイプを示す配列。 これらの値は、Places API で使用される住所のタイプと住所コンポーネントのタイプの表から取得されます。https://developers.google.com/maps/documentation/places/web-service/place-types#address-types |
language_code |
このコンポーネントの形式設定に使用される言語(CLDR 表記)。 |
粒度
場所の粒度。
| 列挙型 | |
|---|---|
GRANULARITY_UNSPECIFIED |
使用しないでください。 |
ROOFTOP |
一致した住所に対応する実際の土地の、補間されていない位置。 |
RANGE_INTERPOLATED |
番地の範囲から補間されています。たとえば、Amphitheatre Pkwy のセグメントに 1600 ~ 1699 の番号が含まれていることがわかっている場合、1650 はそのエンドポイントの中間に配置される可能性があります。 |
GEOMETRIC_CENTER |
ポリゴンデータがある対象物の幾何学的中心。 |
APPROXIMATE |
その他すべて。 |
ImageAnnotation
画像サムネイルのアノテーション(入り口を囲む多角形など)。
| フィールド | |
|---|---|
coordinates[] |
画像上にポリゴンを形成する座標のリスト。座標は反時計回りに並べられます。 |
Coordinate
画像上のポイントのピクセル座標。原点(0,0)は、画像の左上のピクセルの左上隅です。x 軸は右方向、y 軸は下方向を指します。
| フィールド | |
|---|---|
x_px |
X 座標。 |
y_px |
Y 座標。 |
ランドマーク
ランドマークは、目的地の場所を伝えたり、目的地への到着をサポートしたりするために使用されます。
| フィールド | |
|---|---|
relational_description |
目的地とランドマークの関係を説明する、人が読める形式の説明。(例: 「エンパイア ステート ビルの近く」、「ホワイト ハウスの向かい」)。 |
tags[] |
目的地との関連でランドマークをどのように使用できるかを説明するタグ。 |
straight_line_distance_meters |
出力専用。このランドマークから目的地までの直線距離(メートル単位)。 |
travel_distance_meters |
出力専用。このランドマークから目的地までの歩行距離(メートル単位)。 |
共用体フィールド landmark。ランドマーク。landmark は次のいずれかになります。 |
|
place |
このランドマークを表す場所。 |
タグ
目的地との関連でランドマークをどのように使用できるかを示す、すべてのタグのリスト。
住所に ADDRESS タグと ARRIVAL タグの両方が付いている場合、そのランドマークは地域で有名であり、目的地に近いことを意味します。
| 列挙型 | |
|---|---|
TAG_UNSPECIFIED |
使用されません。 |
ADDRESS |
目的地の一般的な位置を特定するために使用できる、地域で有名な場所。通常、目的地から数百メートル以内です。これらは、Geocoding API の住所記述子機能によって返されるランドマークに似ています(https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors)。 |
ARRIVAL |
目的地に到着するのに役立つ場所。目的地に近づいたときにナビゲーションに役立ちます。たとえば、このランドマークは、目的地の向かいにある場所などです。このタグが付いたランドマークは、通常、ADDRESS タグが付いたランドマークよりも目的地に近い場所にあります。 |
PlaceView
Places API の Place のビューを表します。また、構造タイプや表示ポリゴンなど、目的地に固有の追加情報も提供します。
場合によっては、同じプレイス ID を持つ PlaceView が、types フィールドと display_name フィールドで Places API から返されるものと異なることがあります。
| フィールド | |
|---|---|
place |
この Place のリソース名( |
place_id |
場所の固有識別子。 |
display_name |
人が読める形式の場所の説明。例: 「ゲート B」、「マクドナルド」 |
primary_type |
この場所の主な場所タイプ。使用可能な値のリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。 注: このフィールドは必ずしも入力されるとは限りません。このような状況では、 |
types[] |
この場所に関連付けられているすべての場所タイプ。使用可能な値のリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。 |
formatted_address |
1 行の住所。 |
postal_address |
構造化された住所。 |
structure_type |
この場所に対応するストラクチャのタイプ。 |
location |
この場所の所在地。表示ポリゴンがある場所の場合、これは地図上にマーカーを配置するのに適した場所を表すことができます。 |
display_polygon |
GeoJSON 形式の場所のポリゴン アウトライン。RFC 7946 形式(https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6)を使用します。 注: RFC 7946 形式は MultiPolygon をサポートしているため、1 つの |
address_components[] |
各地域レベルの繰り返しコンポーネント。 |
AddressComponent
フォーマットされた住所を構成する構造化コンポーネント(この情報が利用可能な場合)。
| フィールド | |
|---|---|
long_text |
住所コンポーネントの説明または名前。たとえば、オーストラリアの住所コンポーネントの場合、正式名称は「Australia」になります。 |
short_text |
住所コンポーネントの略称(略称がある場合)。たとえば、オーストラリアの住所コンポーネントの場合、略称は「AU」になります。 |
types[] |
住所コンポーネントのタイプを示す配列。 これらの値は、Places API で使用される住所のタイプと住所コンポーネントのタイプの表から取得されます。https://developers.google.com/maps/documentation/places/web-service/place-types#address-types |
language_code |
このコンポーネントの形式設定に使用される言語(CLDR 表記)。 |
StructureType
この場所が表す構造のタイプ。
| 列挙型 | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED |
使用されません。 |
POINT |
ポイント ロケーション。 |
SECTION |
建物の一部。 |
BUILDING |
建物。 |
GROUNDS |
大学のキャンパス、アパート、ショッピング モールなど、通常は複数の建物を含む広いエリア。 |
PlusCode
Plus Code(http://plus.codes)は、2 つの形式を持つ場所の参照情報です。1 つは 14mx14m(1/8000 度)以下の長方形を定義するグローバル コード、もう 1 つは接頭辞を参照場所で置き換える複合コードです。
| フィールド | |
|---|---|
global_code |
場所のグローバル(完全)コード(「9FWM33GV+HQ」など)。8, 000 分の 1 x 8,000 分の 1 度のエリア(約 14 x 14 メートル)を表します。 |
compound_code |
場所の複合コード(「33GV+HQ, Ramberg, Norway」など)。グローバル コードの接尾辞が含まれ、接頭辞が参照エンティティのフォーマットされた名前に置き換えられます。 |
SearchDestinationsRequest
DestinationService.SearchDestinations のリクエスト メッセージ。
| フィールド | |
|---|---|
travel_modes[] |
省略可。ナビゲーション ポイントをフィルタする移動手段。これは、レスポンスで返される |
language_code |
省略可。結果を返す言語。 |
region_code |
省略可。地域コード。地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。このパラメータは、適用される法律に基づいて結果に影響します。このパラメータは、サービスから返される結果に影響を与えますが、完全に制限するわけではありません。 |
共用体フィールド 宛先は、指定されたプライマリ クエリに基づいて構築されます。 注: ナビゲーションの目的地として設定できる場所と住所のみがサポートされています。たとえば、家や集合住宅を表す場所はプライマリ クエリとして使用できますが、地域や行政区域を表す場所はプライマリ クエリとして使用できません。 |
|
place |
場所のリソース名( |
address_query |
番地です。 |
location_query |
正確な位置情報。 |
AddressQuery
検索する番地。対象国の郵便業務で使用されている形式で住所を指定します。
| フィールド | |
|---|---|
共用体フィールド kind。住所クエリ。kind は次のいずれかになります。 |
|
address |
郵送先住所形式の番地。 |
address_query |
1 行でフォーマットされた番地。 |
LocationQuery
近くの主な目的地を特定するための位置情報クエリ。
注: 位置情報クエリがサブプレミスを含む建物内にある場合、返されるメインの場所がサブプレミスになる可能性があります。このような場合、containing_places フィールドに建物が含まれます。
| フィールド | |
|---|---|
place_filter |
省略可。宛先候補に適用するフィルタ。 |
共用体フィールド kind。位置情報クエリ。kind は次のいずれかになります。 |
|
location |
正確な LatLng 位置。 |
PlaceFilter
宛先候補に適用するフィルタ。
| フィールド | |
|---|---|
structure_type |
省略可。指定した場合、すべての目的地にこの構造タイプの主要な場所が必ず含まれます。これにより、一部の目的地が除外されたり、返される目的地が粗くなったり、細かくなったりすることがあります。 たとえば、 このフィールドのもう 1 つの用途は、建物の表示ポリゴンをより簡単に抽出することです。たとえば、 |
addressability |
省略可。指定すると、対応するアドレス可能性の条件を満たす宛先のみが返されます。 |
アドレス指定
アドレス可能性フィルタリングのオプションを定義します。今後、新しい値が追加される可能性があります。
| 列挙型 | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
指定しない場合は、サービスによって適切なデフォルトが選択されます。 |
ANY |
アドレス可能性はフィルタ条件ではありません。宛先は、アドレス指定可能性に関係なく返されます。 |
PRIMARY |
返されるすべての目的地には、番地レベルの住所または名前を持つ主要な場所があります。 |
WEAK |
返されるすべての目的地には、メインの場所またはサブ目的地があり、番地レベルの住所または名前が付けられています。 |
SearchDestinationsResponse
DestinationService.SearchDestinations のレスポンス メッセージ。
| フィールド | |
|---|---|
destinations[] |
宛先のリスト。 プライマリ クエリからプライマリ目的地を一意に特定できる場合、サービスは 1 つの結果を返します。そうしないと、サービスから曖昧性除去のために複数の結果が返されるか、結果が返されない可能性があります。 |
StreetViewThumbnail
Google ストリートビューのサムネイルを表すパラメータ。これらのパラメータを使用して、Street View Static API からストリートビュー画像をリクエストできます。https://developers.google.com/maps/documentation/streetview/request-streetview をご覧ください。
| フィールド | |
|---|---|
pano |
特定のパノラマ ID。 |
width_px |
出力サムネイル画像の幅(ピクセル単位)。注: サムネイルとともにアノテーションをリクエストする場合は、アノテーションの座標が画像と正しく一致するように、ストリートビュー API リクエストでこれらの高さと幅の値を使用する必要があります。 |
height_px |
出力サムネイル画像の高さ(ピクセル単位)。注: サムネイルとともにアノテーションをリクエストする場合は、アノテーションの座標が画像と正しく一致するように、ストリートビュー API リクエストでこれらの高さと幅の値を使用する必要があります。 |
heading_degree |
カメラの水平方向の向き(度単位)。範囲は [0, 360) です。0 は北、90 は東を示します。 |
pitch_degree |
カメラの垂直方向の向き(度単位)。範囲は [-90, 90] です。0 は水平、+90 は真上、-90 は真下です。 |
fov_degree |
水平画角(度単位)。範囲(0、180)。ズームレベルを制御します。FOV が小さいほど、ズームが大きくなります。 |