インデックス
Places
(インターフェース)AddressDescriptor
(メッセージ)AddressDescriptor.Area
(メッセージ)AddressDescriptor.Area.Containment
(列挙型)AddressDescriptor.Landmark
(メッセージ)AddressDescriptor.Landmark.SpatialRelationship
(列挙型)AuthorAttribution
(メッセージ)AutocompletePlacesRequest
(メッセージ)AutocompletePlacesRequest.LocationBias
(メッセージ)AutocompletePlacesRequest.LocationRestriction
(メッセージ)AutocompletePlacesResponse
(メッセージ)AutocompletePlacesResponse.Suggestion
(メッセージ)AutocompletePlacesResponse.Suggestion.FormattableText
(メッセージ)AutocompletePlacesResponse.Suggestion.PlacePrediction
(メッセージ)AutocompletePlacesResponse.Suggestion.QueryPrediction
(メッセージ)AutocompletePlacesResponse.Suggestion.StringRange
(メッセージ)AutocompletePlacesResponse.Suggestion.StructuredFormat
(メッセージ)Circle
(メッセージ)ContentBlock
(メッセージ)ContextualContent
(メッセージ)ContextualContent.Justification
(メッセージ)ContextualContent.Justification.BusinessAvailabilityAttributesJustification
(メッセージ)ContextualContent.Justification.ReviewJustification
(メッセージ)ContextualContent.Justification.ReviewJustification.HighlightedText
(メッセージ)ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange
(メッセージ)EVChargeOptions
(メッセージ)EVChargeOptions.ConnectorAggregation
(メッセージ)EVConnectorType
(列挙型)FuelOptions
(メッセージ)FuelOptions.FuelPrice
(メッセージ)FuelOptions.FuelPrice.FuelType
(列挙型)GetPhotoMediaRequest
(メッセージ)GetPlaceRequest
(メッセージ)Photo
(メッセージ)PhotoMedia
(メッセージ)Place
(メッセージ)Place.AccessibilityOptions
(メッセージ)Place.AddressComponent
(メッセージ)Place.Attribution
(メッセージ)Place.BusinessStatus
(列挙型)Place.ConsumerAlert
(メッセージ)Place.ConsumerAlert.Details
(メッセージ)Place.ConsumerAlert.Details.Link
(メッセージ)Place.ContainingPlace
(メッセージ)Place.EvChargeAmenitySummary
(メッセージ)Place.GenerativeSummary
(メッセージ)Place.GoogleMapsLinks
(メッセージ)Place.NeighborhoodSummary
(メッセージ)Place.OpeningHours
(メッセージ)Place.OpeningHours.Period
(メッセージ)Place.OpeningHours.Period.Point
(メッセージ)Place.OpeningHours.SecondaryHoursType
(列挙型)Place.OpeningHours.SpecialDay
(メッセージ)Place.ParkingOptions
(メッセージ)Place.PaymentOptions
(メッセージ)Place.PlusCode
(メッセージ)Place.ReviewSummary
(メッセージ)Place.SubDestination
(メッセージ)Polyline
(メッセージ)PriceLevel
(列挙型)PriceRange
(メッセージ)Review
(メッセージ)RouteModifiers
(メッセージ)RoutingParameters
(メッセージ)RoutingPreference
(列挙型)RoutingSummary
(メッセージ)RoutingSummary.Leg
(メッセージ)SearchNearbyRequest
(メッセージ)SearchNearbyRequest.LocationRestriction
(メッセージ)SearchNearbyRequest.RankPreference
(列挙型)SearchNearbyResponse
(メッセージ)SearchTextRequest
(メッセージ)SearchTextRequest.EVOptions
(メッセージ)SearchTextRequest.LocationBias
(メッセージ)SearchTextRequest.LocationRestriction
(メッセージ)SearchTextRequest.RankPreference
(列挙型)SearchTextRequest.SearchAlongRouteParameters
(メッセージ)SearchTextResponse
(メッセージ)TravelMode
(列挙型)
場所
Places API のサービス定義。注: すべてのリクエスト(Autocomplete リクエストと GetPhotoMedia リクエストを除く)では、リクエスト proto の外部で設定されたフィールド マスク(all/*
、想定されていません)が必要です。フィールド マスクは、HTTP ヘッダー X-Goog-FieldMask
を介して設定できます。https://developers.google.com/maps/documentation/places/web-service/choose-fields をご覧ください。
AutocompletePlaces |
---|
指定された入力の予測を返します。
|
GetPhotoMedia |
---|
写真参照文字列を使用して写真メディアを取得します。
|
GetPlace |
---|
|
SearchNearby |
---|
場所の近くにある場所を検索します。
|
SearchText |
---|
テキスト クエリに基づく場所検索。
|
AddressDescriptor
場所の相対的な説明。付近のランドマークのランキング セットと、ターゲットの場所との関係を示す正確な包含エリアが含まれます。
フィールド | |
---|---|
landmarks[] |
近くのランドマークのランキング リスト。最も認識しやすく、近くにあるランドマークが最初にランク付けされます。 |
areas[] |
包含または隣接するエリアのランキング リスト。最も認識しやすく正確なエリアが最初にランク付けされます。 |
地域
エリア情報と、エリアとターゲットの場所との関係。
エリアには、場所の説明に役立つ正確な地域の下位区分、近隣地域、大規模な複合施設が含まれます。
フィールド | |
---|---|
name |
エリアのリソース名。 |
place_id |
エリアの Place ID。 |
display_name |
エリアの表示名。 |
containment |
ターゲットの場所とエリアの空間的関係を定義します。 |
封じ込め
ターゲットの場所とエリアの空間的関係を定義します。
列挙型 | |
---|---|
CONTAINMENT_UNSPECIFIED |
コンテインメントは指定されていません。 |
WITHIN |
ターゲットの場所は、エリア リージョンの中央付近にあります。 |
OUTSKIRTS |
ターゲット ロケーションがエリア リージョン内にあり、端に近い。 |
NEAR |
ターゲットの場所はエリア リージョン外ですが、近くにあります。 |
ランドマーク
ランドマークの基本的な情報と、ランドマークと目的地の関係。
ランドマークは、場所の説明に使用できる有名な場所です。
フィールド | |
---|---|
name |
ランドマークのリソース名。 |
place_id |
ランドマークの Place ID。 |
display_name |
ランドマークの表示名。 |
types[] |
このランドマークのタイプタグのセット。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。 |
spatial_relationship |
ターゲットの場所とランドマークの空間関係を定義します。 |
straight_line_distance_meters |
ターゲットの中心点とランドマークの中心点間の直線距離(メートル単位)。状況によっては、この値が |
travel_distance_meters |
ターゲットからランドマークまでの道路網に沿った移動距離(メートル単位)。不明な場合は null。この値は、徒歩、車、自転車などの移動手段を考慮していません。 |
SpatialRelationship
ターゲットの場所とランドマークの空間関係を定義します。
列挙型 | |
---|---|
NEAR |
これは、以下のより具体的な関係のいずれにも該当しない場合のデフォルトの関係です。 |
WITHIN |
ランドマークに空間ジオメトリがあり、ターゲットがその境界内にある。 |
BESIDE |
ターゲットがランドマークに直接隣接している。 |
ACROSS_THE_ROAD |
ターゲットが道路を挟んだランドマークの真向かいにある。 |
DOWN_THE_ROAD |
ランドマークと同じ経路上にあるが、隣または向かい側ではない。 |
AROUND_THE_CORNER |
ランドマークと同じルート上にはないが、1 回曲がれば到達できる。 |
BEHIND |
ランドマークの建物には近いが、道路の入口からは遠い。 |
AuthorAttribution
フィールド | |
---|---|
display_name |
|
uri |
|
photo_uri |
|
AutocompletePlacesRequest
AutocompletePlaces のリクエスト proto。
フィールド | |
---|---|
input |
必須。検索するテキスト文字列。 |
location_bias |
省略可。指定された場所を優先するよう結果にバイアスを設定します。
|
location_restriction |
省略可。結果を特定の場所に制限します。
|
included_primary_types[] |
省略可。Place Types(https://developers.google.com/maps/documentation/places/web-service/place-types)に含まれる主要なプレイス タイプ(「restaurant」や「gas_station」など)、または |
included_region_codes[] |
省略可。指定された地域の結果のみを含めます。最大 15 個の CLDR 2 文字の地域コードで指定します。空のセットは結果を制限しません。 |
language_code |
省略可。結果を返す言語。デフォルトは en-US です。 |
region_code |
省略可。地域コード。CLDR の 2 文字の地域コードで指定します。これは、住所の形式、結果のランキングに影響し、返される結果に影響する可能性があります。これにより、結果が指定されたリージョンに制限されることはありません。結果をリージョンに制限するには、 |
origin |
省略可。目的地点までの測地線距離を計算する出発地点( |
input_offset |
省略可。 空の場合、デフォルトで |
include_query_predictions |
省略可。true の場合、レスポンスには場所とクエリの両方の予測が含まれます。それ以外の場合、レスポンスは場所の予測のみを返します。 |
session_token |
省略可。請求処理のために Autocomplete セッションを識別する文字列。URL とファイル名で安全な base64 文字列で、長さは 36 文字以内の ASCII 文字にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。 セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択し、Place Details または Address Validation が呼び出されると終了します。セッションによっては、複数の検索語句が入力された後に、1 つの Place Details リクエストまたは Address Validation リクエストが送信される場合もあります。セッション内の各リクエストで使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了すると、トークンは無効になります。アプリでは、セッションごとに新しいトークンを生成する必要があります。 次のガイドラインに従うことをおすすめします。
|
include_pure_service_area_businesses |
省略可。フィールドが true に設定されている場合は、非店舗型ビジネスのみを含めます。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに物理的な住所や所在地が登録されていません。これらのビジネスについては、 |
LocationBias
検索する地域。結果は指定したリージョンに偏る可能性があります。
フィールド | |
---|---|
共用体フィールド
|
|
rectangle |
北東と南西の角で定義されたビューポート。 |
circle |
中心点と半径で定義される円。 |
LocationRestriction
検索する地域。結果は指定されたリージョンに制限されます。
フィールド | |
---|---|
共用体フィールド
|
|
rectangle |
北東と南西の角で定義されたビューポート。 |
circle |
中心点と半径で定義される円。 |
AutocompletePlacesResponse
AutocompletePlaces のレスポンス proto。
フィールド | |
---|---|
suggestions[] |
関連性の高い順に並べられた候補のリストが含まれます。 |
候補
予測入力候補の結果。
フィールド | |
---|---|
共用体フィールド
|
|
place_prediction |
プレイスの予測。 |
query_prediction |
クエリの予測。 |
FormattableText
場所またはクエリの予測を表すテキスト。テキストはそのまま使用することも、書式設定することもできます。
フィールド | |
---|---|
text |
そのまま使用するか、 |
matches[] |
入力リクエストが これらの値は、 |
PlacePrediction
Place Autocomplete の予測の予測結果。
フィールド | |
---|---|
place |
提案されたプレイスのリソース名。この名前は、プレイス名を受け入れる他の API で使用できます。 |
place_id |
提案されたプレイスの一意の識別子。この識別子は、プレイス ID を受け入れる他の API で使用できます。 |
text |
返された結果の人が読める形式の名前が含まれます。店舗の検索結果の場合、通常はビジネス名と住所です。
このテキストは、GetPlace から返される リクエストの |
structured_format |
場所の予測を、場所の名前を含むメインテキストと、曖昧さを解消するための追加情報(都市や地域など)を含むセカンダリ テキストに分割します。
|
types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types の表 A または表 B に記載されている、このプレイスに適用されるタイプのリスト。 タイプは、スポットのカテゴリ分けです。タイプが同じ場所は、類似した特徴を共有します。 |
distance_meters |
|
QueryPrediction
クエリのオートコンプリート予測の予測結果。
フィールド | |
---|---|
text |
予測されたテキスト。このテキストはプレイスを表すものではなく、検索エンドポイント(テキスト検索など)で使用できるテキスト クエリを表します。
リクエストの |
structured_format |
クエリ予測を、クエリを含むメインテキストと、曖昧さを解消するための追加の要素(市区町村や地域など)を含むセカンダリ テキストに分割します。
|
StringRange
指定されたテキスト内の部分文字列を識別します。
フィールド | |
---|---|
start_offset |
文字列の最初の Unicode 文字の 0 ベースのオフセット(この値は含まれる)。 |
end_offset |
最後の Unicode 文字の 0 ベースのオフセット(排他的)。 |
StructuredFormat
場所またはクエリの予測をメインテキストとセカンダリ テキストに分割したものが含まれます。
場所の予測の場合、メインテキストには場所の具体的な名前が含まれます。クエリ予測の場合、メインテキストにはクエリが含まれます。
セカンダリ テキストには、場所をさらに特定したり、クエリを絞り込んだりするための追加の曖昧さ回避機能(都市や地域など)が含まれています。
フィールド | |
---|---|
main_text |
Place またはクエリの名前を表します。 |
secondary_text |
場所をさらに特定したり、クエリを絞り込んだりするための追加の曖昧性解消機能(都市や地域など)を表します。 |
サークル
LatLng を中心とし、半径を持つ円。
フィールド | |
---|---|
center |
必須。中心の緯度と経度。 緯度の範囲は [-90.0, 90.0] の範囲内にする必要があります。経度の範囲は [-180.0, 180.0] 内でなければなりません。 |
radius |
必須。半径はメートル単位で測定されます。半径は [0.0, 50000.0] の範囲内にする必要があります。 |
ContentBlock
個別に配信できるコンテンツのブロック。
フィールド | |
---|---|
content |
トピックに関連するコンテンツ。 |
referenced_places[] |
参照されるプレイスのリソース名のリスト。この名前は、Place リソース名を受け入れる他の API で使用できます。 |
ContextualContent
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。
場所クエリのコンテキストに関連するコンテンツ。
フィールド | |
---|---|
reviews[] |
この場所に関するクチコミのリスト。場所のクエリに関連付けられています。 |
photos[] |
この場所の写真に関する情報(参照を含む)。場所のクエリに関連する情報。 |
justifications[] |
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 場所の理由。 |
理由
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。
場所の正当性。正当化は、場所がエンドユーザーの興味を引く可能性がある理由を説明します。
フィールド | |
---|---|
共用体フィールド
|
|
review_justification |
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 |
business_availability_attributes_justification |
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 |
BusinessAvailabilityAttributesJustification
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。BusinessAvailabilityAttributes の正当な理由。これは、ビジネスが持つ属性のうち、エンドユーザーが興味を持つ可能性のあるものを表示しています。
フィールド | |
---|---|
takeout |
テイクアウトを提供しているかどうか。 |
delivery |
お店が配達サービスを提供しているかどうか。 |
dine_in |
イートインを提供しているかどうか。 |
ReviewJustification
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。
ユーザー レビューの正当な理由。エンドユーザーが関心を持つ可能性のあるユーザー レビューのセクションをハイライト表示します。たとえば、検索クエリが「薪窯焼きピザ」の場合、レビューの根拠では検索クエリに関連するテキストがハイライト表示されます。
フィールド | |
---|---|
highlighted_text |
|
review |
ハイライト表示されたテキストの生成元となったレビュー。 |
HighlightedText
正当化によってハイライト表示されたテキスト。これはレビュー自体のサブセットです。ハイライト表示する正確な単語は HighlightedTextRange でマークされます。ハイライト表示されるテキストには複数の単語が含まれている可能性があります。
フィールド | |
---|---|
text |
|
highlighted_text_ranges[] |
ハイライト表示されたテキストの範囲のリスト。 |
HighlightedTextRange
ハイライト表示されたテキストの範囲。
フィールド | |
---|---|
start_index |
|
end_index |
|
EVChargeOptions
Place でホストされている EV 充電スタンドに関する情報。用語は https://afdc.energy.gov/fuels/electricity_infrastructure.html に準拠しています。1 つのポートで一度に 1 台の車を充電できます。1 つのポートには 1 つ以上のコネクタがあります。1 つのステーションに 1 つ以上のポートがあります。
フィールド | |
---|---|
connector_count |
このステーションのコネクタ数。ただし、一部のポートには複数のコネクタがあり、一度に 1 台の車しか充電できないため、コネクタの数が同時に充電できる車の総数よりも多くなることがあります。 |
connector_aggregation[] |
同じタイプで同じ充電レートのコネクタを含む EV 充電コネクタの集計のリスト。 |
ConnectorAggregation
[type, max_charge_rate_kw] でグループ化された EV 充電情報。同じタイプで最大充電レート(kW)のコネクタの EV 充電の集計を表示します。
フィールド | |
---|---|
type |
この集計のコネクタタイプ。 |
max_charge_rate_kw |
集計内の各コネクタの静的な最大充電レート(kW)。 |
count |
この集計内のコネクタの数。 |
availability_last_update_time |
この集計のコネクタの可用性情報が最後に更新されたときのタイムスタンプ。 |
available_count |
この集計で現在使用可能なコネクタの数。 |
out_of_service_count |
この集計で現在サービス停止中のコネクタの数。 |
EVConnectorType
EV 充電コネクタの種類の詳細情報 / コンテキストについては、http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 をご覧ください。
列挙型 | |
---|---|
EV_CONNECTOR_TYPE_UNSPECIFIED |
コネクタが指定されていません。 |
EV_CONNECTOR_TYPE_OTHER |
その他のコネクタの種類。 |
EV_CONNECTOR_TYPE_J1772 |
J1772 タイプ 1 コネクタ。 |
EV_CONNECTOR_TYPE_TYPE_2 |
IEC 62196 タイプ 2 コネクタ。MENNEKES とも呼ばれます。 |
EV_CONNECTOR_TYPE_CHADEMO |
CHAdeMO タイプのコネクタ。 |
EV_CONNECTOR_TYPE_CCS_COMBO_1 |
Combined Charging System(AC および DC)。SAE に基づきます。Type-1 J-1772 コネクタ |
EV_CONNECTOR_TYPE_CCS_COMBO_2 |
Combined Charging System(AC および DC)。Type-2 Mennekes コネクタに基づく |
EV_CONNECTOR_TYPE_TESLA |
汎用 TESLA コネクタ。北米では NACS ですが、他の地域では NACS 以外の場合があります(CCS Combo 2(CCS2)や GB/T など)。この値は実際のコネクタタイプを表すものではなく、テスラ ブランドの車両をテスラ所有の充電ステーションで充電できることを表しています。 |
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T |
GB/T タイプは、中国の GB/T 標準に対応しています。この型はすべての GB_T 型をカバーします。 |
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET |
コンセントが指定されていません。 |
EV_CONNECTOR_TYPE_NACS |
北米充電規格(NACS)。SAE J3400 として標準化されています。 |
FuelOptions
ガソリンスタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。
フィールド | |
---|---|
fuel_prices[] |
このガソリンスタンドで取り扱っている燃料の種類ごとの最新の燃料価格。このステーションが取り扱っている燃料の種類ごとに 1 つのエントリがあります。順序は重要ではありません。 |
FuelPrice
特定の種類の燃料の価格情報。
フィールド | |
---|---|
type |
燃料の種類。 |
price |
燃料の価格。 |
update_time |
燃料価格が最後に更新された日時。 |
FuelType
燃料の種類。
列挙型 | |
---|---|
FUEL_TYPE_UNSPECIFIED |
燃料タイプが指定されていません。 |
DIESEL |
ディーゼル燃料。 |
DIESEL_PLUS |
ディーゼル燃料。 |
REGULAR_UNLEADED |
レギュラー ガソリン。 |
MIDGRADE |
中間グレード。 |
PREMIUM |
Premium。 |
SP91 |
SP 91. |
SP91_E10 |
SP 91 E10。 |
SP92 |
SP 92. |
SP95 |
SP 95。 |
SP95_E10 |
SP95 E10。 |
SP98 |
SP 98. |
SP99 |
SP 99. |
SP100 |
SP 100. |
LPG |
液化石油ガス。 |
E80 |
E 80。 |
E85 |
E 85. |
E100 |
E 100. |
METHANE |
メタン。 |
BIO_DIESEL |
バイオディーゼル。 |
TRUCK_DIESEL |
トラックのディーゼル。 |
GetPhotoMediaRequest
写真リソース名を使用して場所の写真をフェッチするリクエスト。
フィールド | |
---|---|
name |
必須。写真メディアのリソース名(形式: Place オブジェクトの |
max_width_px |
省略可。画像の最大幅(ピクセル単位)を指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元のアスペクト比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。max_height_px プロパティと max_width_px プロパティの両方で、1 ~ 4, 800 の整数(両端を含む)を指定できます。値が許容範囲内にない場合は、INVALID_ARGUMENT エラーが返されます。 max_height_px または max_width_px の少なくとも 1 つを指定する必要があります。max_height_px と max_width_px のどちらも指定されていない場合は、INVALID_ARGUMENT エラーが返されます。 |
max_height_px |
省略可。画像の高さの最大値をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元のアスペクト比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。max_height_px プロパティと max_width_px プロパティの両方で、1 ~ 4, 800 の整数(両端を含む)を指定できます。値が許容範囲内にない場合は、INVALID_ARGUMENT エラーが返されます。 max_height_px または max_width_px の少なくとも 1 つを指定する必要があります。max_height_px と max_width_px のどちらも指定されていない場合は、INVALID_ARGUMENT エラーが返されます。 |
skip_http_redirect |
省略可。設定されている場合、デフォルトの HTTP リダイレクト動作をスキップし、テキスト形式(HTTP ユースケースの場合は JSON 形式など)のレスポンスをレンダリングします。設定されていない場合は、HTTP リダイレクトが発行され、呼び出しが画像メディアにリダイレクトされます。このオプションは、HTTP 以外のリクエストでは無視されます。 |
GetPlaceRequest
places/{place_id}
形式の文字列であるリソース名に基づいてプレイスを取得するリクエスト。
フィールド | |
---|---|
name |
必須。場所のリソース名( |
language_code |
省略可。ビジネスの詳細が、指定した言語で表示されます(可能な場合)。 現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。 |
region_code |
省略可。リクエストの送信元となるロケーションの Unicode 国/リージョン コード(CLDR)。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。 現在、3 桁の地域コードはサポートされていません。 |
session_token |
省略可。請求処理のために Autocomplete セッションを識別する文字列。URL とファイル名で安全な base64 文字列で、長さは 36 文字以内の ASCII 文字にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。 セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択し、Place Details または Address Validation が呼び出されると終了します。セッションによっては、複数の検索語句が入力された後に、1 つの Place Details リクエストまたは Address Validation リクエストが送信される場合もあります。セッション内の各リクエストで使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了すると、トークンは無効になります。アプリでは、セッションごとに新しいトークンを生成する必要があります。 次のガイドラインに従うことをおすすめします。
|
写真
場所の写真に関する情報。
フィールド | |
---|---|
name |
ID。この場所の写真を再度検索するために使用できる、この場所の写真を指す参照(API の「リソース」名 |
width_px |
利用可能な最大幅(ピクセル単位)。 |
height_px |
利用可能な高さの最大値(ピクセル単位)。 |
author_attributions[] |
この写真の作成者。 |
flag_content_uri |
ユーザーが写真に関する問題を報告できるリンク。 |
google_maps_uri |
Google マップに写真を表示するためのリンク。 |
PhotoMedia
Places API の写真メディア。
フィールド | |
---|---|
name |
写真メディアのリソース名(形式: |
photo_uri |
写真のレンダリングに使用できる有効期間の短い URI。 |
場所
場所を表すすべての情報。
フィールド | |
---|---|
name |
このプレイスのリソース名( |
id |
場所の一意の識別子。 |
display_name |
場所のローカライズされた名前。人が読める短い説明として適しています。例: 「Google Sydney」、「Starbucks」、「Pyrmont」など。 |
types[] |
この結果の型タグのセット。たとえば、「political」や「locality」などです。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。 |
primary_type |
指定された結果のプライマリ タイプ。このタイプは、Places API でサポートされているタイプのいずれかである必要があります。たとえば、「レストラン」、「カフェ」、「空港」などです。1 つのプレイスに指定できるプライマリ タイプは 1 つのみです。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。プライマリ タイプが存在する場合、それは常に |
primary_type_display_name |
メインのタイプの表示名。該当する場合は、リクエスト言語にローカライズされます。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。 |
national_phone_number |
場所の人が読める形式の電話番号(国内形式)。 |
international_phone_number |
場所の電話番号(人が読める形式、国際電話形式)。 |
formatted_address |
この場所の人が読める形式の完全な住所。 |
short_formatted_address |
この場所の人が読める形式の短い住所。 |
postal_address |
郵便住所形式の住所。 |
address_components[] |
地域レベルごとに繰り返されるコンポーネント。address_components[] 配列については、次の点に注意してください。- 住所コンポーネントの配列には、formatted_address よりも多くのコンポーネントが含まれている場合があります。- この配列には、formatted_address に含まれているもの以外の住所を持つ行政区画が、すべて含まれているとは限りません。特定の住所を含むすべての行政区画を取得するには、リバース ジオコーディングを使用して住所の緯度と経度をパラメータとしてリクエストに渡します。- レスポンスの形式は、リクエスト間で同じになるとは限りません。特に、address_components の数はリクエストされた住所によって異なり、同じ住所でも将来的に変わる可能性があります。コンポーネントは、配列内の位置が変わる場合があります。コンポーネントのタイプは変わる場合があります。特定のコンポーネントが以降のレスポンスに含まれない場合があります。 |
plus_code |
場所の緯度/経度の Plus Code。 |
location |
この場所の位置。 |
viewport |
平均的なサイズの地図に場所を表示するのに適したビューポート。このビューポートは、ビジネスの物理的な境界やサービス提供地域として使用しないでください。 |
rating |
この場所のユーザー レビューに基づく 1.0 ~ 5.0 の評価。 |
google_maps_uri |
この場所に関する詳細情報を提供する URL。 |
website_uri |
当該の場所の公式ウェブサイト(会社のホームページなど)。チェーン店(IKEA など)の場合、通常はチェーン全体のウェブサイトではなく、個々の店舗のウェブサイトになります。 |
reviews[] |
この場所に関するクチコミのリスト。関連性の高い順に並べ替えられます。返されるレビューは最大 5 件です。 |
regular_opening_hours |
通常の営業時間。場所が年中無休(24 時間営業)の場合、 |
time_zone |
IANA タイムゾーン データベースのタイムゾーン。たとえば、「America/New_York」。 |
photos[] |
この場所の写真に関する情報(参照を含む)。最大 10 枚の写真が返されます。 |
adr_format_address |
adr マイクロフォーマットでの場所の住所: http://microformats.org/wiki/adr。 |
business_status |
場所のビジネス ステータス。 |
price_level |
場所の価格帯。 |
attributions[] |
この結果とともに表示する必要があるデータ プロバイダのセット。 |
icon_mask_base_uri |
アイコン マスクの短縮 URL。ユーザーは、末尾にタイプ サフィックス(「.svg」や「.png」など)を追加することで、さまざまなアイコン タイプにアクセスできます。 |
icon_background_color |
icon_mask の背景色(16 進数形式、例: #909CE1)。 |
current_opening_hours |
次の 7 日間(今日を含む)の営業時間。期間は、リクエスト日の午前 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、例外的な営業時間がある日付に設定されたすべての時間の special_days サブフィールドが含まれます。 |
current_secondary_opening_hours[] |
ビジネスの営業時間に関する情報など、次の 7 日間のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次的な営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト(ドライブスルー、受け取り、テイクアウトなど)から取得されたタイプ サブフィールドが入力されます。このフィールドには、例外的な営業時間がある日付に設定されたすべての時間の special_days サブフィールドが含まれます。 |
regular_secondary_opening_hours[] |
ビジネスの通常の二次的な時間帯に関する情報のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次的な営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト(ドライブスルー、受け取り、テイクアウトなど)から取得されたタイプ サブフィールドが入力されます。 |
editorial_summary |
場所の概要が含まれています。概要はテキストによる概要で構成され、該当する場合は言語コードも含まれます。要約テキストは現状のまま提示する必要があり、変更や改変はできません。 |
payment_options |
その場所で利用できるお支払い方法。お支払い方法のデータが利用できない場合、お支払い方法のフィールドは設定されません。 |
parking_options |
スポットが提供する駐車場のオプション。 |
sub_destinations[] |
場所に関連するサブデスティネーションのリスト。 |
fuel_options |
ガソリンスタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。 |
ev_charge_options |
電気自動車の充電オプションに関する情報。 |
generative_summary |
AI 生成による場所の概要。 |
containing_places[] |
現在地が位置する場所のリスト。 |
address_descriptor |
場所の住所記述子。住所記述子には、ランドマークやエリアを使用して場所を説明するのに役立つ追加情報が含まれます。住所記述子の地域別の対応状況については、https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage をご覧ください。 |
google_maps_links |
さまざまな Google マップのアクションをトリガーするリンク。 |
price_range |
プレイスに関連付けられた価格帯。 |
review_summary |
ユーザー レビューを使用した場所の AI 生成の概要。 |
ev_charge_amenity_summary |
EV 充電スタンドの近くにある施設の概要。 |
neighborhood_summary |
場所の近くにあるスポットの概要。 |
consumer_alert |
ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。 |
utc_offset_minutes |
この場所のタイムゾーンの現在の UTC からのオフセット(分単位)。これは、X 時間 15 分など、1 時間の端数でオフセットされるタイムゾーンをサポートするために、分単位で表されます。 |
user_rating_count |
この場所のクチコミ(テキストあり / なし)の合計数。 |
takeout |
テイクアウトに対応しているかどうかを指定します。 |
delivery |
ビジネスが宅配サービスをサポートしているかどうかを指定します。 |
dine_in |
ビジネスが屋内席または屋外席のオプションをサポートしているかどうかを指定します。 |
curbside_pickup |
ビジネスがカーブサイド ピックアップをサポートしているかどうかを指定します。 |
reservable |
その場所で予約が可能かどうかを指定します。 |
serves_breakfast |
朝食を提供しているかどうかを指定します。 |
serves_lunch |
ランチを提供しているかどうかを指定します。 |
serves_dinner |
ディナーを提供しているかどうかを指定します。 |
serves_beer |
ビールを提供しているかどうかを指定します。 |
serves_wine |
ワインを提供しているかどうかを指定します。 |
serves_brunch |
ブランチ メニューがあるかどうかを指定します。 |
serves_vegetarian_food |
ベジタリアン料理を提供しているかどうかを指定します。 |
outdoor_seating |
テラス席がある。 |
live_music |
ライブ演奏を楽しめる。 |
menu_for_children |
キッズメニューがある。 |
serves_cocktails |
カクテルを提供するお店。 |
serves_dessert |
デザートあり。 |
serves_coffee |
コーヒーを提供している。 |
good_for_children |
子供連れに適した場所です。 |
allows_dogs |
犬の同伴可。 |
restroom |
トイレあり。 |
good_for_groups |
場所はグループに対応しています。 |
good_for_watching_sports |
スポーツ観戦に適した場所です。 |
accessibility_options |
場所が提供するユーザー補助オプションに関する情報。 |
pure_service_area_business |
その場所が非店舗型ビジネスのみかどうかを示します。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに住所や所在地が掲載されていない場合があります。 |
AccessibilityOptions
場所が提供するユーザー補助オプションに関する情報。
フィールド | |
---|---|
wheelchair_accessible_parking |
車椅子対応の駐車場がある。 |
wheelchair_accessible_entrance |
車椅子対応の入り口がある場所。 |
wheelchair_accessible_restroom |
車椅子対応のトイレがある。 |
wheelchair_accessible_seating |
車椅子対応の座席がある。 |
AddressComponent
書式設定された住所を構成する構造化コンポーネント(この情報が利用可能な場合)。
フィールド | |
---|---|
long_text |
住所コンポーネントの説明または名前。たとえば、オーストラリアの住所コンポーネントの場合、long_name は「Australia」になります。 |
short_text |
住所コンポーネントの略称(略称がある場合)。たとえば、オーストラリアの住所コンポーネントの short_name は「AU」になります。 |
types[] |
住所コンポーネントのタイプを示す配列。 |
language_code |
このコンポーネントのフォーマットに使用される言語(CLDR 表記)。 |
アトリビューション
この場所のデータ プロバイダに関する情報。
フィールド | |
---|---|
provider |
プレイスのデータ プロバイダの名前。 |
provider_uri |
プレイスのデータ プロバイダの URI。 |
BusinessStatus
プレイスのビジネス ステータス。
列挙型 | |
---|---|
BUSINESS_STATUS_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
OPERATIONAL |
施設は営業中ですが、必ずしも現在営業しているとは限りません。 |
CLOSED_TEMPORARILY |
この施設は臨時休業しています。 |
CLOSED_PERMANENTLY |
この施設は閉業しています。 |
ConsumerAlert
ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。
フィールド | |
---|---|
overview |
消費者アラート メッセージの概要。 |
details |
消費者アラート メッセージの詳細。ƒ |
language_code |
消費者向け警告メッセージの言語コード。これは BCP 47 言語コードです。 |
詳細
消費者アラート メッセージの詳細。
フィールド | |
---|---|
title |
説明とともに表示するタイトル。 |
description |
消費者向けアラート メッセージの説明。 |
about_link |
詳細情報を提供するために説明とともに表示するリンク。 |
リンク
詳細情報を提供するために説明とともに表示するリンク。
フィールド | |
---|---|
title |
リンクに表示するタイトル。 |
uri |
リンクの URI。 |
ContainingPlace
この場所がある場所に関する情報。
フィールド | |
---|---|
name |
この場所が位置する場所のリソース名。 |
id |
この場所がある場所のプレイス ID。 |
EvChargeAmenitySummary
EV 充電スタンドの近くにある施設の概要。これは、タイプが electric_vehicle_charging_station
の場所にのみ適用されます。overview
フィールドは必ず提供されますが、他のフィールドは省略可能です。
フィールド | |
---|---|
overview |
利用可能なアメニティの概要。これは必ず提供されます。 |
coffee |
近くのコーヒー ショップの概要。 |
restaurant |
近くのレストランの概要。 |
store |
近くの店舗の概要。 |
flag_content_uri |
ユーザーが要約に関する問題を報告できるリンク。 |
disclosure_text |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
GenerativeSummary
AI 生成による場所の概要。
フィールド | |
---|---|
overview |
場所の概要。 |
overview_flag_content_uri |
概要の要約に関する問題を報告できるリンク。 |
disclosure_text |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
GoogleMapsLinks
さまざまな Google マップのアクションをトリガーするリンク。
フィールド | |
---|---|
directions_uri |
目的地までの経路を表示するリンク。このリンクでは、目的地のみが入力され、デフォルトの交通手段 |
place_uri |
この場所を表示するリンク。 |
write_a_review_uri |
Google マップでこの場所のクチコミを投稿するためのリンク。 |
reviews_uri |
この場所のクチコミを Google マップで表示するためのリンク。 |
photos_uri |
この場所のクチコミを Google マップで表示するためのリンク。 |
NeighborhoodSummary
場所の近くにあるスポットの概要。
フィールド | |
---|---|
overview |
近隣地域の概要。 |
description |
近隣地域の詳細な説明。 |
flag_content_uri |
ユーザーが要約に関する問題を報告できるリンク。 |
disclosure_text |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
OpeningHours
場所の営業時間に関する情報。
フィールド | |
---|---|
periods[] |
1 週間のうち、この場所が営業している期間。期間は、場所のローカル タイムゾーンで時系列順に並べられます。空の値(欠損値ではない)は、一時的に休業しているなど、営業していない場所を示します。
注: |
weekday_descriptions[] |
この場所の営業時間を表すローカライズされた文字列。1 週間ごとに 1 つの文字列。 注: 曜日の順序と週の始まりは、ロケール(言語と地域)によって決まります。 時間が不明な場合や、ローカライズされたテキストに変換できなかった場合は空になります。例: 「日: 18:00 ~ 06:00」 |
secondary_hours_type |
補助時間のタイプを識別するために使用される型文字列。 |
special_days[] |
返された営業時間の対象期間内の特別な日の構造化情報。特別な日は、場所の営業時間に影響を与える可能性のある日です(クリスマスなど)。例外的な営業時間がある場合は、current_opening_hours と current_secondary_opening_hours に設定します。 |
next_open_time |
現在の営業時間帯の次の開始時間(最大 7 日後)。このフィールドは、リクエストの処理時に営業時間帯が有効でない場合にのみ入力されます。 |
next_close_time |
現在の営業時間の期間が終了するまでの残り日数(最大 7 日)。このフィールドは、リクエストの配信時に営業時間帯が有効な場合にのみ入力されます。 |
open_now |
営業時間帯が現在有効かどうか。通常の営業時間と現在の営業時間の場合、このフィールドはスポットが営業しているかどうかを示します。サブ営業時間と現在のサブ営業時間の場合、このフィールドは、この場所のサブ営業時間が有効かどうかを示します。 |
期間
場所が open_now ステータスのままになっている期間。
フィールド | |
---|---|
open |
その場所の営業開始時間。 |
close |
店舗が閉店し始める時間。 |
ポイント
ステータス変更ポイント。
フィールド | |
---|---|
date |
場所の現地タイムゾーンの日付。 |
truncated |
このエンドポイントが切り捨てられたかどうか。切り捨ては、実際の時間が時間の範囲外にある場合に発生します。この場合、時間を範囲内に切り捨てます。これにより、リクエストの日の午前 0 時から最大 24 * 7 時間が返されます。 |
day |
曜日(0 ~ 6 の整数)。0 は日曜日、1 は月曜日などです。 |
hour |
24 時間形式の時間。範囲は 0 ~ 23 です。 |
minute |
分。範囲は 0 ~ 59 です。 |
SecondaryHoursType
二次時間のタイプを識別するために使用される型。
列挙型 | |
---|---|
SECONDARY_HOURS_TYPE_UNSPECIFIED |
セカンダリ時間タイプが指定されていない場合のデフォルト値。 |
DRIVE_THROUGH |
銀行、レストラン、薬局のドライブスルーの営業時間。 |
HAPPY_HOUR |
ハッピーアワー。 |
DELIVERY |
配達時間。 |
TAKEOUT |
テイクアウト対応時間。 |
KITCHEN |
キッチンの営業時間。 |
BREAKFAST |
朝食の時間。 |
LUNCH |
昼食の時間。 |
DINNER |
夕食の時間。 |
BRUNCH |
ブランチの時間。 |
PICKUP |
集荷時間。 |
ACCESS |
保管場所のアクセス時間。 |
SENIOR_HOURS |
高齢者向けの特別営業時間。 |
ONLINE_SERVICE_HOURS |
オンライン サービスの提供時間。 |
SpecialDay
返された営業時間の対象期間内の特別な日の構造化情報。特別な日は、場所の営業時間に影響を与える可能性のある日です(クリスマスなど)。
フィールド | |
---|---|
date |
この特別な日の日付。 |
ParkingOptions
場所の駐車オプションに関する情報。駐車場は複数のオプションを同時にサポートできます。
フィールド | |
---|---|
free_parking_lot |
無料駐車場あり。 |
paid_parking_lot |
有料駐車場がある場所。 |
free_street_parking |
無料の路上駐車が可能です。 |
paid_street_parking |
有料の路上駐車場あり。 |
valet_parking |
係員による駐車サービスあり。 |
free_garage_parking |
屋内駐車場を無料で利用可能。 |
paid_garage_parking |
有料の屋内駐車場あり。 |
PaymentOptions
その場所で利用できるお支払い方法。
フィールド | |
---|---|
accepts_credit_cards |
クレジット カードによる支払いが可能です。 |
accepts_debit_cards |
デビットカードによる支払いが可能です。 |
accepts_cash_only |
支払いは現金のみです。この属性が設定されている場所でも、他のお支払い方法が利用できる場合があります。 |
accepts_nfc |
NFC モバイル決済が可能です。 |
PlusCode
Plus Code(http://plus.codes)は、14 メートル x 14 メートル(8000 分の 1 度)以下の長方形を定義するグローバル コードと、プレフィックスを参照位置に置き換える複合コードの 2 つの形式を持つ位置参照です。
フィールド | |
---|---|
global_code |
場所のグローバル(完全な)コード(「9FWM33GV+HQ」など)。8000 分の 1 度 x 8000 分の 1 度(約 14 メートル x 14 メートル)の領域を表します。 |
compound_code |
場所の複合コード(「33GV+HQ, Ramberg, Norway」など)。グローバル コードの接尾辞が含まれ、接頭辞が参照エンティティの書式設定された名前に置き換えられています。 |
ReviewSummary
ユーザー レビューを使用した場所の AI 生成の概要。
フィールド | |
---|---|
text |
ユーザー レビューの概要。 |
flag_content_uri |
ユーザーが要約に関する問題を報告できるリンク。 |
disclosure_text |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
reviews_uri |
この場所のクチコミを Google マップで表示するためのリンク。 |
SubDestination
サブスポットは、メインのスポットに関連付けられた特定の場所です。空港、国立公園、大学、スタジアムなど、広大で複雑な場所を検索しているユーザーに、より具体的な目的地を提供します。たとえば、空港のサブ目的地には、関連するターミナルや駐車場が含まれることがあります。サブデスティネーションは、プレイス ID とプレイス リソース名を返します。これらは、後続の Place Details(新版)リクエストで使用して、サブデスティネーションの表示名や位置情報などの詳細情報を取得できます。
フィールド | |
---|---|
name |
サブ宛先のリソース名。 |
id |
サブ目的地のプレイス ID。 |
ポリライン
ルートのポリライン。エンコードされたポリラインのみをサポートします。これは文字列として渡すことができ、最小限の損失で圧縮されます。これは Routes API のデフォルトの出力です。
フィールド | |
---|---|
共用体フィールド polyline_type 。ポリラインのタイプをカプセル化します。Routes API の出力はデフォルトで encoded_polyline になります。polyline_type は次のいずれかになります。 |
|
encoded_polyline |
Routes API がデフォルトで返すエンコードされたポリライン。エンコーダ ツールとデコーダ ツールをご覧ください。 |
PriceLevel
場所の価格帯。
列挙型 | |
---|---|
PRICE_LEVEL_UNSPECIFIED |
場所の価格帯が指定されていないか不明です。 |
PRICE_LEVEL_FREE |
無料サービスを提供している場所。 |
PRICE_LEVEL_INEXPENSIVE |
手頃な価格でサービスを提供している。 |
PRICE_LEVEL_MODERATE |
適度な価格のサービスを提供している場所。 |
PRICE_LEVEL_EXPENSIVE |
高額なサービスを提供している。 |
PRICE_LEVEL_VERY_EXPENSIVE |
非常に高額なサービスを提供している。 |
PriceRange
プレイスに関連付けられた価格帯。end_price
は設定されていない場合もあります。これは上限のない範囲(「$100 以上」など)を示します。
フィールド | |
---|---|
start_price |
価格帯の下限(この値を含む)。価格はこの金額以上である必要があります。 |
end_price |
価格帯の上限(この値を含まない)。価格はこの金額より低くする必要があります。 |
確認
場所のレビューに関する情報。
フィールド | |
---|---|
name |
この場所のクチコミを表す参照。この場所のクチコミを再度検索するために使用できます(API の「リソース」名とも呼ばれます: |
relative_publish_time_description |
言語と国 / 地域に適した形式で、現在の時刻に対するレビュー時刻を相対的に表す、最近の時刻のフォーマットされた文字列。 |
text |
ローカライズされたレビューのテキスト。 |
original_text |
元の言語のレビュー テキスト。 |
rating |
1.0 ~ 5.0 の数値(星の数とも呼ばれます)。 |
author_attribution |
このレビューの投稿者。 |
publish_time |
レビューのタイムスタンプ。 |
flag_content_uri |
ユーザーがクチコミに関する問題を報告できるリンク。 |
google_maps_uri |
Google マップでクチコミを表示するためのリンク。 |
visit_date |
クチコミ投稿者がその場所を訪れた日付。これは月に切り捨てられます。 |
RouteModifiers
ルートの計算時に満たす必要がある一連のオプション条件をカプセル化します。
フィールド | |
---|---|
avoid_tolls |
省略可。true に設定すると、有料道路を避けることが可能な場合は、有料道路を含まないルートを優先します。 |
avoid_highways |
省略可。true に設定すると、高速道路を回避できる場合は回避し、高速道路を含まないルートを優先します。 |
avoid_ferries |
省略可。true に設定すると、フェリーを回避できる場合はフェリーを回避し、フェリーを含まないルートを優先します。 |
avoid_indoor |
省略可。true に設定すると、屋内ナビゲーションを含まないルートを優先して、可能な限り屋内ナビゲーションを回避します。 |
RoutingParameters
レスポンス内の場所へのルート計算を構成するパラメータ。ルートに沿った場所(結果のランキングに影響する)と、結果の移動時間を計算する場所の両方。
フィールド | |
---|---|
origin |
省略可。ポリラインで定義された出発地をオーバーライドする明示的なルーティング出発地。デフォルトでは、ポリラインの原点が使用されます。 |
travel_mode |
省略可。移動手段。 |
route_modifiers |
省略可。ルート修飾子。 |
routing_preference |
省略可。ルーティングの概要を計算する方法を指定します。サーバーは、選択されたルーティング設定を使用してルートの計算を試みます。トラフィック アウェア ルーティング設定は、 |
RoutingPreference
ルートの計算時に考慮する要素を指定する値のセット。
列挙型 | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
転送設定が指定されていません。デフォルトは TRAFFIC_UNAWARE です。 |
TRAFFIC_UNAWARE |
リアルタイムの交通状況を考慮せずにルートを計算します。交通状況が重要でない場合や適用されない場合に適しています。この値を使用すると、レイテンシが最小になります。注: 、DRIVE 、TWO_WHEELER の場合、現在の道路状況ではなく、道路網と平均的な交通状況(時間的な要素を考慮に入れない)に基づいてルートと所要時間が選択されます。そのため、一時的に通行止めとなっている道路がルートに含まれることがあります。道路網における状況の変化、平均的な交通状況の最新情報、サービスの分散性などにより、リクエストの結果が時間の経過とともに変化する可能性があります。また、結果は、ほぼ同等のルートでも、時刻やリクエストの頻度によって異なる場合があります。 |
TRAFFIC_AWARE |
リアルタイムの交通状況を考慮してルートを計算します。TRAFFIC_AWARE_OPTIMAL とは対照的に、レイテンシを大幅に短縮するために最適化が適用されます。 |
TRAFFIC_AWARE_OPTIMAL |
ほとんどのパフォーマンス最適化を適用せずに、現在の交通状況を考慮してルートを計算します。この値を使用すると、レイテンシが最も高くなります。 |
RoutingSummary
リクエストされた場合、レスポンス内の場所までのルートの出発地からの所要時間と距離、その場所から目的地までの 2 つ目の区間。注: routingParameters.origin
パラメータまたは searchAlongRouteParameters.polyline.encodedPolyline
パラメータのいずれかをリクエストに含めずに、フィールド マスクに routingSummaries
を追加すると、エラーが発生します。
フィールド | |
---|---|
legs[] |
旅行の区間。 出発地を 1 つ指定して移動時間と距離を計算する場合、 |
directions_uri |
指定されたルート概要の経由地を使用して Google マップで経路を表示するリンク。このリンクで生成されるルートは、ルーティングの概要の生成に使用されたルートと同じであるとは限りません。このリンクは、リクエストで提供された情報(該当する場合は |
脚
区間とは、ある場所から別の場所への移動の 1 つの部分です。
フィールド | |
---|---|
duration |
この区間の所要時間。 |
distance_meters |
この旅行区間の距離。 |
SearchNearbyRequest
Nearby Search のリクエスト プロトコル。
フィールド | |
---|---|
language_code |
ビジネスの詳細が、指定した言語で表示されます(可能な場合)。言語コードが指定されていないか認識されない場合は、任意の言語の場所の詳細が返される可能性があります。そのような詳細が存在する場合は、英語が優先されます。 現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。 |
region_code |
リクエストの送信元となるロケーションの Unicode 国/リージョン コード(CLDR)。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。 詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。 現在、3 桁の地域コードはサポートされていません。 |
included_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types の場所のタイプ(「restaurant」や「gas_station」など)を含めました。 表 A から最大 50 個のタイプを指定できます。 競合するタイプ(included_types と excluded_types の両方にタイプが表示される場合)がある場合は、INVALID_ARGUMENT エラーが返されます。 複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。 |
excluded_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types から除外された場所のタイプ(「restaurant」や「gas_station」など)。 表 A から最大 50 個のタイプを指定できます。 クライアントが included_types(レストランなど)と excluded_types(カフェなど)の両方を指定した場合、レスポンスにはレストランだがカフェではない場所が含まれる必要があります。レスポンスには、included_types のいずれか 1 つ以上に一致し、excluded_types のいずれにも一致しない場所が含まれます。 競合するタイプ(included_types と excluded_types の両方にタイプが表示される場合)がある場合は、INVALID_ARGUMENT エラーが返されます。 複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。 |
included_primary_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types の主要なプレイス タイプ(「restaurant」や「gas_station」など)を含めました。場所に関連付けることができるサポートされているタイプのテーブルのプライマリ タイプは 1 つのみです。 表 A から最大 50 個のタイプを指定できます。 競合するプライマリ タイプ(included_primary_types と excluded_primary_types の両方にタイプが含まれている場合)がある場合は、INVALID_ARGUMENT エラーが返されます。 複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。 |
excluded_primary_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types から主要なプレイス タイプ(「restaurant」や「gas_station」など)を除外しました。 表 A から最大 50 個のタイプを指定できます。 競合するプライマリ タイプ(included_primary_types と excluded_primary_types の両方にタイプが含まれている場合)がある場合は、INVALID_ARGUMENT エラーが返されます。 複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。 |
max_result_count |
返される結果の最大数。1 ~ 20(デフォルト)の範囲で指定してください。この数が設定されていない場合、上限にフォールバックします。数値が負の値に設定されているか、上限を超えている場合は、INVALID_ARGUMENT エラーが返されます。 |
location_restriction |
必須。検索する地域。 |
rank_preference |
レスポンスで結果がランク付けされる方法。 |
routing_parameters |
省略可。検索結果へのルーティングに影響するパラメータ。 |
LocationRestriction
検索する地域。
フィールド | |
---|---|
共用体フィールド
|
|
circle |
中心点と半径で定義される円。 |
RankPreference
レスポンスで結果がランク付けされる方法。
列挙型 | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
RankPreference 値が設定されていません。デフォルトでは、人気度によるランキングが使用されます。 |
DISTANCE |
距離で結果をランク付けします。 |
POPULARITY |
結果を人気度でランク付けします。 |
SearchNearbyResponse
付近の検索のレスポンス proto。
フィールド | |
---|---|
places[] |
場所のタイプ、場所の数、特定の場所の制限など、ユーザーの要件を満たす場所のリスト。 |
routing_summaries[] |
ルーティングの概要のリスト。各エントリは、 |
SearchTextRequest
SearchText のリクエスト プロトコル。
フィールド | |
---|---|
text_query |
必須。テキスト検索のテキスト クエリ。 |
language_code |
ビジネスの詳細が、指定した言語で表示されます(可能な場合)。言語コードが指定されていないか認識されない場合は、任意の言語の場所の詳細が返される可能性があります。そのような詳細が存在する場合は、英語が優先されます。 現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。 |
region_code |
リクエストの送信元となるロケーションの Unicode 国/リージョン コード(CLDR)。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。 詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。 現在、3 桁の地域コードはサポートされていません。 |
rank_preference |
レスポンスで結果がランク付けされる方法。 |
included_type |
リクエストされたスポットタイプ。サポートされているタイプの完全なリスト: https://developers.google.com/maps/documentation/places/web-service/place-types。含めることができるタイプは 1 つのみです。 |
open_now |
検索対象を現在営業中の場所に制限するために使用します。デフォルトは false です。 |
min_rating |
ユーザーの平均評価がこの上限を厳密に下回る結果を除外します。有効な値は、0 ~ 5(両端を含む)の範囲の浮動小数点数で、0.5 の刻み幅で指定する必要があります([0, 0.5, 1.0, ... , 5.0] の両端を含む)。入力された評価は、最も近い 0.5(天井)に切り上げられます。たとえば、評価が 0.6 の場合、評価が 1.0 未満の結果はすべて除外されます。 |
max_result_count |
非推奨: 代わりに、 ページごとに返される結果の最大数。取得可能な結果の数が
|
page_size |
省略可。ページごとに返される結果の最大数。取得可能な結果の数が
|
page_token |
省略可。前回の TextSearch 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。 ページネーションを行う場合、TextSearch に指定する |
price_levels[] |
検索対象を特定の価格帯の場所のみに制限するために使用します。ユーザーは料金レベルを自由に組み合わせることができます。デフォルトでは、すべての価格レベルが選択されています。 |
strict_type_filtering |
included_type の厳密な型フィルタリングを設定するために使用されます。true に設定すると、同じタイプの結果のみが返されます。デフォルトは false です。 |
location_bias |
検索する地域。この位置はバイアスとして機能するため、指定された位置周辺の結果が返される可能性があります。location_restriction と同時に設定することはできません。 |
location_restriction |
検索する地域。この位置情報は制限として機能します。つまり、指定された位置情報の外にある結果は返されません。location_bias と同時に設定することはできません。 |
ev_options |
省略可。場所検索リクエストの検索可能な EV オプションを設定します。 |
routing_parameters |
省略可。結果へのルーティングの追加パラメータ。 |
search_along_route_parameters |
省略可。ルート沿いの検索用の追加パラメータの proto。 |
include_pure_service_area_businesses |
省略可。フィールドが true に設定されている場合は、非店舗型ビジネスのみを含めます。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに物理的な住所や所在地が登録されていません。これらのビジネスについては、 |
EVOptions
場所検索リクエストの検索可能な EV オプション。
フィールド | |
---|---|
minimum_charging_rate_kw |
省略可。最低限必要な充電率(キロワット)。充電レートが指定されたレートよりも低い場所は除外されます。 |
connector_types[] |
省略可。優先する EV コネクタの種類のリスト。リストされているコネクタタイプをサポートしていない場所は除外されます。 |
LocationBias
検索する地域。この位置はバイアスとして機能するため、指定された位置周辺の結果が返される可能性があります。
フィールド | |
---|---|
共用体フィールド
|
|
rectangle |
北東と南西の角で定義された長方形のボックス。 |
circle |
中心点と半径で定義される円。 |
LocationRestriction
検索する地域。この位置情報は制限として機能します。つまり、指定された位置情報の外にある結果は返されません。
フィールド | |
---|---|
共用体フィールド
|
|
rectangle |
北東と南西の角で定義された長方形のボックス。 |
RankPreference
レスポンスで結果がランク付けされる方法。
列挙型 | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
「ニューヨークのレストラン」などのカテゴリ検索の場合、デフォルトは RELEVANCE です。「Mountain View, CA」などのカテゴリ以外のクエリの場合は、rankPreference を設定しないままにしておくことをおすすめします。 |
DISTANCE |
距離で結果をランク付けします。 |
RELEVANCE |
結果を関連性でランク付けします。並べ替え順は通常のランキング スタックによって決定されます。 |
SearchAlongRouteParameters
検索するルートを定義する Routes API から事前計算されたポリラインを指定します。ルートに沿った検索は、locationBias
または locationRestriction
リクエスト オプションを使用して検索結果をバイアスするのと同様です。ただし、locationBias
オプションと locationRestriction
オプションでは検索結果をバイアスする地域を指定できますが、このオプションではルート沿いの結果をバイアスできます。
結果は、指定されたルートに沿って表示されるとは限りません。ポリラインと、必要に応じて locationBias
または locationRestriction
で定義された検索エリア内で、出発地から目的地までの最小迂回時間に基づいてランク付けされます。特に、指定されたポリラインが出発地から目的地までの最適なルートを定義していない場合、結果は代替ルートに沿ったものになる可能性があります。
フィールド | |
---|---|
polyline |
必須。ルートのポリライン。 |
SearchTextResponse
SearchText のレスポンス プロトコル。
フィールド | |
---|---|
places[] |
ユーザーのテキスト検索条件を満たす場所のリスト。 |
routing_summaries[] |
ルーティングの概要のリスト。各エントリは、 |
contextual_contents[] |
試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 コンテキスト コンテンツのリスト。各エントリは、場所フィールドの同じインデックスの対応する場所に関連付けられます。リクエスト内の |
next_page_token |
次のページを取得するために |
search_uri |
リンクを使用すると、リクエストで指定されたテキスト クエリと同じテキスト クエリで Google マップを検索できます。 |
TravelMode
移動手段のオプション。これらのオプションは、Routes API が提供する機能に対応しています。
列挙型 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
移動手段が指定されていません。デフォルトは DRIVE です。 |
DRIVE |
乗用車で移動します。 |
BICYCLE |
自転車で移動します。search_along_route_parameters ではサポートされていません。 |
WALK |
徒歩で移動します。search_along_route_parameters ではサポートされていません。 |
TWO_WHEELER |
スクーターやオートバイなど、あらゆる種類の原動機付き二輪車。これは、人力による移動手段を対象とする BICYCLE 移動手段とは異なります。search_along_route_parameters ではサポートされていません。二輪車が一般的な多くの国と地域に対応に記載されている国でのみサポートされます。 |