Package google.maps.geocode.v4beta

インデックス

GeocodeService

ジオコーディングを実行するサービス。

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

このメソッドは、住所を LatLng にマッピングする住所ジオコードを実行します。また、住所に関する構造化された情報も提供します。

認可スコープ

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

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

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

このメソッドは、LatLng を住所にマッピングする位置ジオコードを実行します。また、住所に関する構造化された情報も提供します。

認可スコープ

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

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

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

このメソッドは、プレイス ID を使用してジオコード検索を行います。

認可スコープ

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

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

GeocodeAddressRequest

GeocodeService.GeocodeAddress のリクエスト メッセージ。

フィールド
location_bias

GeocodeAddressRequest.LocationBias

省略可。検索する地域。この位置はバイアスとして機能するため、指定された位置周辺の結果が返される可能性があります。
language_code

string

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

string

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

string

ジオコーディングする構造化されていない住所。
address

PostalAddress

郵便住所形式でジオコードする構造化された住所。

LocationBias

検索する地域。この位置はバイアスとして機能するため、指定された位置周辺の結果が返される可能性があります。

フィールド
共用体フィールド type。位置情報のバイアスの種類。type は次のいずれかになります。
rectangle

Viewport

北東と南西の角で定義された長方形のボックス。rectangle.high() は、長方形のビューポートの北東の点である必要があります。rectangle.low() は、長方形のビューポートの南西の点である必要があります。rectangle.low().latitude() は rectangle.high().latitude() より大きくすることはできません。これにより、緯度範囲が空になります。長方形のビューポートの幅は 180 度以下にしてください。

GeocodeAddressResponse

GeocodeService.GeocodeAddress に対するレスポンス メッセージです。

フィールド
results[]

GeocodeResult

ジオコーディングの結果。

GeocodeLocationRequest

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

フィールド
language_code

string

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

string

省略可。地域コード。ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定される地域コード。このパラメータは、適用される法律に基づいて結果に影響します。
types[]

string

省略可。結果を制限する型タグのセット。指定されたタイプのいずれにも該当しない結果は削除されます。

使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。
granularity[]

GeocodeResult.Granularity

省略可。1 つ以上の位置情報の粒度列挙型のフィルタ。
共用体フィールド location_input。ジオコーディングする場所。location_input は次のいずれかになります。
location_query

string

「lat,lng」文字列形式の位置情報。例: 「64.7611872,-18.4705364」。
location

LatLng

構造化された形式の場所。

GeocodeLocationResponse

GeocodeService.GeocodeLocation に対するレスポンス メッセージです。

フィールド
results[]

GeocodeResult

ジオコーディングの結果。
plus_code

PlusCode

リクエスト内の場所の Plus Code。

GeocodePlaceRequest

GeocodeService.GeocodePlace のリクエスト メッセージ。

フィールド
place

string

必須。ジオコーディングする場所の識別子。places/{place} の形式。
language_code

string

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

string

省略可。地域コード。ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定される地域コード。このパラメータは、適用される法律に基づいて結果に影響します。

GeocodeResult

ジオコード結果には、場所に関する地理情報が含まれています。

フィールド
place

string

この結果の完全修飾された場所 ID。「//places.googleapis.com/places/{placeID}」の形式で指定します。詳しくは、https://developers.google.com/maps/documentation/places/web-service/place-id をご覧ください。
place_id

string

この結果のプレイス ID。
location

LatLng

この住所の緯度経度。
granularity

GeocodeResult.Granularity

位置情報の粒度。
viewport

Viewport

ジオコーディング結果の表示に適したビューポート。
bounds

Viewport

住所の境界ボックス。
formatted_address

string

1 行でフォーマットされた住所。
postal_address

PostalAddress

郵便住所形式の住所。
address_components[]

GeocodeResult.AddressComponent

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

LocalizedText

郵便番号に含まれる地域区分の完全なリスト。

結果のタイプが「postal_code」の場合にのみ入力されます。
types[]

string

この結果の型タグのセット。たとえば、「political」や「administrative_area」などです。

使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。
plus_code

PlusCode

このジオコード内の場所の Plus Code。

AddressComponent

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

フィールド
long_text

string

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

string

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

string

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

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

string

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

粒度

位置情報の粒度。

列挙型
GRANULARITY_UNSPECIFIED 使用しないでください。
ROOFTOP 一致した住所に対応する実際の土地の非補間位置。
RANGE_INTERPOLATED 番地の範囲から補間されます。たとえば、Amphitheatre Pkwy のある区間に 1600 ～ 1699 の番号が含まれていることがわかっている場合、1650 はその区間の両端の中間地点に配置される可能性があります。
GEOMETRIC_CENTER ポリゴン データがあるフィーチャーの幾何学的中心。
APPROXIMATE その他すべて。

PlusCode

Plus Code（http://plus.codes）は、14 メートル x 14 メートル（8000 分の 1 度）以下の長方形を定義するグローバル コードと、プレフィックスを参照位置に置き換える複合コードの 2 つの形式を持つ位置参照です。

フィールド
global_code

string

場所のグローバル（完全な）コード（「9FWM33GV+HQ」など）。8000 分の 1 度 x 8000 分の 1 度の領域（約 14 メートル x 14 メートル）を表します。
compound_code

string

場所の複合コード（「33GV+HQ, Ramberg, Norway」など）。グローバル コードの接尾辞が含まれ、接頭辞が参照エンティティの書式設定された名前に置き換えられています。