Places Service

PlacesService クラス

google.maps.places.PlacesService クラス

場所の検索と場所の詳細情報の取得に関連するメソッドが含まれます。

const {PlacesService} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlacesService
PlacesService(attrContainer)
パラメータ: 
指定されたコンテナで帰属を表示する PlacesService の新しいインスタンスを作成します。
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
パラメータ: 
戻り値: なし
電話番号に基づいて場所のリストを取得します。ほとんどの場合、結果リストには 1 つのアイテムのみが含まれますが、リクエストが曖昧な場合は複数の結果が返されることがあります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリは、PlacesService.getDetails を呼び出して目的の場所の PlaceResult.place_id を渡すことで、各場所のより詳細な PlaceResult を取得できます。
findPlaceFromQuery
findPlaceFromQuery(request, callback)
パラメータ: 
戻り値: なし
クエリ文字列に基づいて場所のリストを取得します。ほとんどの場合、結果リストには 1 つのアイテムのみが含まれますが、リクエストが曖昧な場合は複数の結果が返されることがあります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリは、PlacesService.getDetails を呼び出して目的の場所の PlaceResult.place_id を渡すことで、各場所のより詳細な PlaceResult を取得できます。
getDetails
getDetails(request, callback)
パラメータ: 
戻り値: なし
指定された placeId で識別される場所の詳細を取得します。
nearbySearch
nearbySearch(request, callback)
パラメータ: 
戻り値: なし
キーワードまたはタイプに基づいて、特定の場所の近くにある場所のリストを取得します。ロケーションは常に指定する必要があります。LatLngBounds パラメータ、または location パラメータと radius パラメータを渡すことで指定できます。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリでは、目的の場所の PlaceResult.place_id を渡す Place Details リクエストを送信することで、各場所のより詳細な PlaceResult を取得できます。PlaceSearchPagination オブジェクトを使用して、結果の追加ページを取得できます（結果の最後のページである場合、または結果のページが 1 つしかない場合は null）。
textSearch
textSearch(request, callback)
パラメータ: 
戻り値: なし
クエリ文字列（「ニューヨークのピザ屋」、「オタワ周辺の靴屋」など）に基づいて、場所のリストを取得します。位置パラメータは省略可能です。位置を指定すると、結果はエリア内の場所に限定されるのではなく、近くの結果にのみバイアスがかけられます。任意の文字列を使用して場所を検索する場合や、検索結果を特定の場所に制限したくない場合は、textSearch を使用します。PlaceSearchPagination オブジェクトを使用して、結果の追加ページを取得できます（結果の最後のページである場合、または結果のページが 1 つしかない場合は null）。

PlaceDetailsRequest インターフェース

google.maps.places.PlaceDetailsRequest インターフェース

PlacesService に送信される Place Details クエリ。
placeId
タイプ:  string
詳細がリクエストされているプレイスのプレイス ID。
fields optional
タイプ:  Array<string> optional
詳細レスポンスに含めるフィールド。課金対象となります。フィールドが指定されていない場合、または ['ALL'] が渡された場合は、使用可能なフィールドがすべて返され、課金されます（本番環境のデプロイでは推奨されません）。フィールドの一覧については、PlaceResult をご覧ください。ネストされたフィールドは、ドットパス（"geometry.location" など）で指定できます。
language optional
タイプ:  string optional
詳細を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
region optional
タイプ:  string optional
ユーザーの地域の地域コード。これにより、返される写真やその他の結果に影響する可能性があります。地域コードには、ccTLD（「トップレベル ドメイン」）の 2 文字の値を指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。
sessionToken optional
タイプ:  AutocompleteSessionToken optional
詳細リクエストを予測入力セッションとバンドルするために使用される一意の参照。

FindPlaceFromPhoneNumberRequest インターフェース

google.maps.places.FindPlaceFromPhoneNumberRequest インターフェース

PlacesService.findPlaceFromPhoneNumber に送信されるテキスト検索リクエストから場所を検索します。
fields
タイプ:  Array<string>
レスポンスに含めるフィールド。課金対象となります。['ALL'] が渡された場合は、使用可能なフィールドがすべて返され、課金されます（本番環境のデプロイでは推奨されません）。フィールドの一覧については、PlaceResult をご覧ください。ネストされたフィールドは、ドットパス（"geometry.location" など）で指定できます。
phoneNumber
タイプ:  string
検索する場所の電話番号。形式は E.164 である必要があります。
language optional
タイプ:  string optional
可能な場合、名前と住所を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
locationBias optional
タイプ:  LocationBias optional
プレイスの検索に使用されるバイアス。結果は、指定された LocationBias にバイアスされますが、それに限定されません。

FindPlaceFromQueryRequest インターフェース

google.maps.places.FindPlaceFromQueryRequest インターフェース

PlacesService.findPlaceFromQuery に送信されるテキスト検索リクエストから場所を検索します。
fields
タイプ:  Array<string>
レスポンスに含めるフィールド。課金対象となります。['ALL'] が渡された場合は、使用可能なフィールドがすべて返され、課金されます（本番環境のデプロイでは推奨されません）。フィールドの一覧については、PlaceResult をご覧ください。ネストされたフィールドは、ドットパス（"geometry.location" など）で指定できます。
query
タイプ:  string
リクエストのクエリ。たとえば、場所の名前や住所などです。
language optional
タイプ:  string optional
可能な場合、名前と住所を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
locationBias optional
タイプ:  LocationBias optional
プレイスの検索に使用されるバイアス。結果は、指定された LocationBias にバイアスされますが、それに限定されません。

PlaceSearchRequest インターフェース

google.maps.places.PlaceSearchRequest インターフェース

PlacesService に送信される Place 検索クエリ。
bounds optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
プレイスを検索する境界。bounds が設定されている場合、location と radius の両方が無視されます。
keyword optional
タイプ:  string optional
利用可能なすべてのフィールドを検索対象とする語句を示します。名前やタイプ、住所をはじめとして、カスタマー レビューやサードパーティ コンテンツも対象となります。
language optional
タイプ:  string optional
可能な場合、名前と住所を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
location optional
タイプ:  LatLng|LatLngLiteral optional
プレイスを検索する場所。
maxPriceLevel optional
タイプ:  number optional
結果を指定した料金レベル以下の場所のみに制限します。有効な値の範囲は 0（最も安い）〜4（最も高い）です。指定する場合は、minPrice 以上にする必要があります。
minPriceLevel optional
タイプ:  number optional
結果を指定した料金レベル以上の場所のみに制限します。有効な値の範囲は 0（最も安い）〜4（最も高い）です。指定する場合は、maxPrice 以下にする必要があります。
name optional
タイプ:  string optional
keyword と同じです。このフィールドの値は、keyword フィールドの値と組み合わされて、同じ検索文字列の一部として渡されます。
openNow optional
タイプ:  boolean optional
検索結果を現在営業中の場所のみに制限します。
radius optional
タイプ:  number optional
指定された場所からプレイスを検索する距離（メートル単位）。最大値は 50,000 です。
rankBy optional
タイプ:  RankBy optional
デフォルト: RankBy.PROMINENCE
結果を返すときに使用するランキング方法を指定します。なお、rankBy を DISTANCE に設定する場合は、location を指定する必要がありますが、radius または bounds は指定できません。
type optional
タイプ:  string optional
指定されたタイプの場所を検索します。このタイプは、リクエストの対象地域の言語に翻訳され、クエリ文字列として使用されます。クエリも指定されている場合は、ローカライズされたタイプ文字列に連結されます。別のタイプの結果はレスポンスから削除されます。このフィールドを使用して、言語や地域に依存しないカテゴリ検索を実行します。有効なタイプについては、こちらをご覧ください。

TextSearchRequest インターフェース

google.maps.places.TextSearchRequest インターフェース

PlacesService に送信されるテキスト検索リクエスト。
bounds optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
プレイスを検索する際に結果のバイアスに使用する境界（省略可）。bounds が設定されている場合、location と radius の両方が無視されます。検索結果は指定した範囲内に限定されませんが、範囲内の結果は上位に表示されます。
language optional
タイプ:  string optional
可能な場合、名前と住所を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
location optional
タイプ:  LatLng|LatLngLiteral optional
場所を検索する際に結果をバイアスするために使用されるエリアの中心。
query optional
タイプ:  string optional
リクエストのクエリ語句。たとえば、場所の名前（「エッフェル塔」）、カテゴリと場所の名前（「ニューヨークのピザ」）、場所の名前と場所の曖昧さ回避（「シドニーのスターバックス」）などです。
radius optional
タイプ:  number optional
場所を検索する際に結果のバイアスに使用されるエリアの半径（メートル単位）。
region optional
タイプ:  string optional
結果のバイアスを設定する地域コード。地域コードには、ccTLD（「トップレベル ドメイン」）の 2 文字の値を指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。
type optional
タイプ:  string optional
指定されたタイプの場所を検索します。このタイプは、リクエストの対象地域の言語に翻訳され、クエリ文字列として使用されます。クエリも指定されている場合は、ローカライズされたタイプ文字列に連結されます。別のタイプの結果はレスポンスから削除されます。このフィールドを使用して、言語や地域に依存しないカテゴリ検索を実行します。有効なタイプについては、こちらをご覧ください。

RankBy 定数

google.maps.places.RankBy 定数

PlaceSearchRequest のランキング オプション。

const {RankBy} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
DISTANCE 場所からの距離に基づいて場所の検索結果をランク付けします。
PROMINENCE 場所の検索結果を知名度でランク付けします。

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias は、場所を検索する際に使用するソフトな境界またはヒントを表します。指定した範囲外の結果が返されることもあります。現在のユーザーの IP アドレスをバイアスとして使用するには、文字列 "IP_BIAS" を指定します。注: Circle を使用する場合は、中心と半径を定義する必要があります。

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction は、プレイスの検索時に使用する厳密な境界を表します。

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus 定数

google.maps.places.PlacesServiceStatus 定数

検索の完了時に PlacesService によって返されるステータス。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'OK' や google.maps.places.PlacesServiceStatus.OK です。

const {PlacesServiceStatus} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
INVALID_REQUEST リクエストが無効です。
NOT_FOUND 参照された場所が見つかりませんでした。
OK レスポンスには有効な結果が含まれています。
OVER_QUERY_LIMIT アプリケーションがリクエスト割り当てを超過しています。
REQUEST_DENIED アプリケーションで PlacesService の使用が許可されていません。
UNKNOWN_ERROR サーバーエラーが原因で PlacesService リクエストを処理できませんでした。もう一度試すと正常に処理される可能性があります。
ZERO_RESULTS このリクエストに対する結果は見つかりませんでした。

PlaceSearchPagination インターフェース

google.maps.places.PlaceSearchPagination インターフェース

場所の結果の追加ページを取得するために使用されるオブジェクト。
hasNextPage
タイプ:  boolean
追加の結果があるかどうかを示します。true: 追加の結果ページがある場合に返されます。
nextPage
nextPage()
パラメータ: なし
戻り値:  void
結果の次のページを取得します。最初の検索リクエストに提供されたのと同じコールバック関数を使用します。

PlaceResult インターフェース

google.maps.places.PlaceResult インターフェース

場所に関する情報を定義します。
address_components optional
タイプ:  Array<GeocoderAddressComponent> optional
このプレイスのロケーションの住所構成要素のコレクション。PlacesService.getDetails でのみ使用できます。
adr_address optional
タイプ:  string optional
adr マイクロフォーマットでのプレイスの住所の表現。PlacesService.getDetails でのみ使用できます。
aspects optional
タイプ:  Array<PlaceAspectRating> optional
Google と Zagat のユーザー レビューに基づく、この場所の評価対象の側面。評価は 0 ～ 30 の範囲で表示されます。
business_status optional
タイプ:  BusinessStatus optional
その場所の営業状況を示すフラグ（場所がお店やサービスの場合）。その場所が営業中か、臨時休業中か、または完全に閉業しているかを示します。データがない場合、このフラグは検索レスポンスまたは詳細レスポンスに表示されません。
formatted_address optional
タイプ:  string optional
プレイスの完全な住所。
formatted_phone_number optional
タイプ:  string optional
電話番号の地域慣例に従ってフォーマットされた場所の電話番号。PlacesService.getDetails でのみ使用できます。
geometry optional
タイプ:  PlaceGeometry optional
場所のジオメトリに関する情報。
html_attributions optional
タイプ:  Array<string> optional
この場所の結果に対して表示される帰属表示テキスト。リクエストされた fields にかかわらず、利用可能な html_attributions は常に返され、表示される必要があります。
icon optional
タイプ:  string optional
この場所のカテゴリを表すために使用できる画像リソースへの URL。
icon_background_color optional
タイプ:  string optional
場所のアイコンで使用する背景色。PlaceResult.icon_mask_base_uri もご覧ください。
icon_mask_base_uri optional
タイプ:  string optional
アイコン マスクの短縮 URL。ファイル拡張子（.svg や .png など）を末尾に追加することで、さまざまなアイコンタイプにアクセスできます。
international_phone_number optional
タイプ:  string optional
国際電話形式の場所の電話番号。国際電話番号形式は、「+」記号と国コードが先頭に付きます。PlacesService.getDetails でのみ使用できます。
name optional
タイプ:  string optional
場所の名前。注: ユーザーが入力した場所の場合、これはユーザーが入力したとおりの生のテキストです。悪意のあるユーザーがこのデータをコード インジェクション攻撃のベクトルとして使用しようとする可能性があるため、このデータを使用する際は注意してください（ http://en.wikipedia.org/wiki/Code_injection を参照）。
opening_hours optional
タイプ:  PlaceOpeningHours optional
プレイスの開店時間と閉店時間を定義します。
permanently_closed optional
タイプ:  boolean optional
スポットが閉業（一時的または永久的）しているかどうかを示すフラグ。場所が営業中の場合、またはデータがない場合、レスポンスにフラグは含まれません。
photos optional
タイプ:  Array<PlacePhoto> optional
この場所の写真。コレクションには最大 10 個の PlacePhoto オブジェクトが含まれます。
place_id optional
タイプ:  string optional
プレイスの一意の識別子。
plus_code optional
タイプ:  PlacePlusCode optional
プレイスの Open Location Code（「Plus Code」）を定義します。
price_level optional
タイプ:  number optional
場所の価格帯（0 ～ 4）。価格帯は次のように解釈されます。
  • 0: 無料
  • 1: 安価
  • 2: 中程度
  • 3: 高価
  • 4: 非常に高い
rating optional
タイプ:  number optional
この場所のユーザー レビューに基づく 1.0 ～ 5.0 の評価。
reviews optional
タイプ:  Array<PlaceReview> optional
この場所のクチコミのリスト。PlacesService.getDetails でのみ使用できます。
types optional
タイプ:  Array<string> optional
この場所のタイプの配列（["political", "locality"] や ["restaurant", "establishment"] など）。
url optional
タイプ:  string optional
この場所の公式 Google ページの URL。これは、この場所について入手可能な最良の情報を含む Google のページです。PlacesService.getDetails でのみ使用できます。
user_ratings_total optional
タイプ:  number optional
このスポットの PlaceResult.rating に貢献したユーザー評価の数。
utc_offset optional
タイプ:  number optional
場所の現在のタイムゾーンの UTC からのオフセット（分単位）。たとえば、オーストラリアのシドニーは夏時間では UTC より 11 時間進んでいるため、utc_offset は 660 になります。UTC より遅れているタイムゾーンの場合、オフセットは負の値になります。たとえば、カーボベルデの utc_offset は -60 です。PlacesService.getDetails でのみ使用できます。
utc_offset_minutes optional
タイプ:  number optional
場所の現在のタイムゾーンの UTC からのオフセット（分単位）。たとえば、オーストラリアのシドニーは夏時間では UTC より 11 時間進んでいるため、utc_offset_minutes は 660 になります。UTC より遅れているタイムゾーンの場合、オフセットは負の値になります。たとえば、カーボベルデの utc_offset_minutes は -60 です。PlacesService.getDetails でのみ使用できます。
vicinity optional
タイプ:  string optional
場所の簡単な住所です。番地や市町村などが含まれ、州、都道府県、郵便番号、国などは含まれません。たとえば、オーストラリアにある Google のシドニー オフィスの vicinity の値は "48 Pirrama Road, Pyrmont" です。PlacesService.getDetails でのみ使用できます。
website optional
タイプ:  string optional
会社のホームページなど、当該の場所の公式ウェブサイト。PlacesService.getDetails でのみ使用できます。

PlaceAspectRating インターフェース

google.maps.places.PlaceAspectRating インターフェース

ユーザーがレビューした場所の側面に関する情報を定義します。
rating
タイプ:  number
このアスペクトの評価。個々のレビューの場合、これは 0 ～ 3 の整数です。場所の集計評価の場合、これは 0 ～ 30 の整数です。
type
タイプ:  string
アスペクト タイプ。たとえば、"food"、"decor"、"service"、"overall" などです。

BusinessStatus 定数

google.maps.places.BusinessStatus 定数

場所の営業状況（場所がお店やサービスの場合）。PlaceResult で返されます（場所が営業中か、臨時休業中か、または完全に閉業しているかを示します）。これらは値または定数の名前（例: 'OPERATIONAL'、google.maps.places.BusinessStatus.OPERATIONAL）で指定します。

const {BusinessStatus} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
CLOSED_PERMANENTLY ビジネスが閉業している。
CLOSED_TEMPORARILY ビジネスは一時的に休業しています。
OPERATIONAL ビジネスは通常どおり営業しています。

PlaceGeometry インターフェース

google.maps.places.PlaceGeometry インターフェース

プレイスのジオメトリに関する情報を定義します。
location optional
タイプ:  LatLng optional
プレイスの場所。
viewport optional
タイプ:  LatLngBounds optional
この Place を地図に表示する際の優先ビューポート。このプロパティは、プレイスの推奨ビューポートが不明な場合は null になります。PlacesService.getDetails でのみ使用できます。

PlaceOpeningHours インターフェース

google.maps.places.PlaceOpeningHours インターフェース

プレイスの営業時間に関する情報を定義します。
open_now optional
タイプ:  boolean optional
現在、プレイスが営業しているかどうか。
periods optional
タイプ:  Array<PlaceOpeningHoursPeriod> optional
日曜日から始まる各曜日の営業時間帯を時系列で格納します。休業日は含まれません。PlacesService.getDetails でのみ使用できます。
weekday_text optional
タイプ:  Array<string> optional
1 週間の各曜日の書式設定された営業時間を表す 7 つの文字列の配列。プレイス サービスは、現在の言語に合わせて営業時間を適切にフォーマットしてローカライズします。この配列の要素の順序は言語によって異なります。1 週間が月曜日から始まる言語もあれば、日曜日から始まる言語もあります。PlacesService.getDetails でのみ使用できます。他の呼び出しでは空の配列が返されることがあります。
isOpen
isOpen([date])
パラメータ: 
  • date:  Date optional
戻り値:  boolean|undefined
場所が現在営業しているか（日付が渡されていない場合）、指定された日付に営業しているかを確認します。このスポットに PlaceResult.utc_offset_minutes または PlaceOpeningHours.periods がない場合は、undefined が返されます（PlaceOpeningHours.periods は PlacesService.getDetails 経由でのみ使用できます）。このメソッドでは、祝日などの例外的な時間は考慮されません。

PlaceOpeningHoursPeriod インターフェース

google.maps.places.PlaceOpeningHoursPeriod インターフェース

場所の営業時間の構造化された情報を定義します。注: 場所が年中無休の場合は、レスポンスに close セクションは含まれません。open 期間に値が 0 の day と、値が "0000" の time が含まれており、close が含まれていなければ、クライアントはこれを年中無休であると判断できます。
open
プレイスの営業開始時間。
close optional
タイプ:  PlaceOpeningHoursTime optional
プレイスの閉店時間。

PlaceOpeningHoursTime インターフェース

google.maps.places.PlaceOpeningHoursTime インターフェース

場所の開店時間と閉店時間を定義します。
day
タイプ:  number
日曜日から始まる、[0, 6] の範囲の数値で表される曜日。たとえば、2 は火曜日を意味します。
hours
タイプ:  number
PlaceOpeningHoursTime.time の時間（数値）。範囲は [0, 23] です。これは場所のタイムゾーンで報告されます。
minutes
タイプ:  number
PlaceOpeningHoursTime.time の分を数値で表します。範囲は [0, 59] です。これは場所のタイムゾーンで報告されます。
time
タイプ:  string
時刻（24 時間形式の「hhmm」）。値は ["0000", "2359"] の範囲内です。時間は場所のタイムゾーンで報告されます。
nextDate optional
タイプ:  number optional
この PlaceOpeningHoursTime の次の発生を表すタイムスタンプ（エポックからのミリ秒数。new Date() での使用に適しています）。週の PlaceOpeningHoursTime.day、PlaceOpeningHoursTime.time、PlaceResult.utc_offset_minutes から計算されます。PlaceResult.utc_offset_minutes が undefined の場合、nextDate は undefined になります。

PlacePlusCode インターフェース

google.maps.places.PlacePlusCode インターフェース

場所の Open Location Code（「プラスコード」）を定義します。Plus Codes は、番地がない場所（建物に番号が付いていない場所や、通りに名前がない場所）で、番地の代わりに使用できます。
global_code
タイプ:  string
8000 分の 1 x 8000 分の 1 の領域のプラスコード。例: "8FVC9G8F+5W"
compound_code optional
タイプ:  string optional
最初の 4 文字（エリアコード）が削除され、地域の説明に置き換えられた、1/8000 度 × 1/8000 度のエリアのプラスコード。例: "9G8F+5W Zurich, Switzerland"コードを短縮できる適切な地域が見つからない場合、このフィールドは省略されます。

PlacePhoto インターフェース

google.maps.places.PlacePhoto インターフェース

プレイスのフォト要素を表します。
height
タイプ:  number
写真の高さ（ピクセル単位）。
html_attributions
タイプ:  Array<string>
この写真に表示する帰属テキスト。
width
タイプ:  number
写真の幅（ピクセル単位）。
getUrl
getUrl([opts])
パラメータ: 
戻り値:  string
指定されたオプションに対応する画像 URL を返します。

PhotoOptions インターフェース

google.maps.places.PhotoOptions インターフェース

写真リクエスト オプションを定義します。
maxHeight optional
タイプ:  number optional
返される画像の最大高さ（ピクセル単位）。
maxWidth optional
タイプ:  number optional
返される画像の最大幅（ピクセル単位）。

PlaceReview インターフェース

google.maps.places.PlaceReview インターフェース

場所の単一のクチコミを表します。
author_name
タイプ:  string
クチコミ投稿者の名前。
language
タイプ:  string
このクチコミの言語を表す IETF 言語コード。このコードには、国または地域を示す 2 次タグは含まれず、メイン言語のタグのみが含まれます。たとえば、英語のクチコミはすべてが 'en' とタグ付けされ、「en-AU」や「en-UK」などのタグは含まれません。
profile_photo_url
タイプ:  string
レビュー投稿者のプロフィール画像への URL。
relative_time_description
タイプ:  string
言語と国 / 地域に適した形式で、現在の時刻に対するレビュー時刻を相対的に表す、最近の時刻の書式設定された文字列。例: "a month ago"
text
タイプ:  string
レビューのテキスト。
time
タイプ:  number
クチコミのタイムスタンプ（エポックからの経過秒数）。
aspects optional
タイプ:  Array<PlaceAspectRating> optional
レビューで評価された側面。0 ～ 3 の段階評価。
author_url optional
タイプ:  string optional
レビュー投稿者のプロフィールへの URL。審査者のプロフィールが利用できない場合は undefined になります。
rating optional
タイプ:  number optional
このレビューの評価。1.0 ～ 5.0 の数値（両端を含む）。