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 のサブセットです。アプリで各場所の詳細な PlaceResult を取得するには、PlacesService.getDetails を呼び出して、目的の場所の PlaceResult.place_id を渡します。
findPlaceFromQuery
findPlaceFromQuery(request, callback)
パラメータ: 
戻り値: なし
クエリ文字列に基づいて場所のリストを取得します。ほとんどの場合、結果リストには項目が 1 つだけ必要ですが、リクエストが不明瞭な場合は、複数の結果が返されることがあります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリで各場所の詳細な PlaceResult を取得するには、PlacesService.getDetails を呼び出して、目的の場所の PlaceResult.place_id を渡します。
getDetails
getDetails(request, callback)
パラメータ: 
戻り値: なし
指定された placeId で識別される場所の詳細を取得します。
nearbySearch
nearbySearch(request, callback)
パラメータ: 
戻り値: なし
キーワードまたはタイプに基づいて、特定の場所の付近にある場所のリストを取得します。location は、必ず LatLngBounds パラメータ、location パラメータ、radius パラメータを渡すことで指定する必要があります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリは、Place Details リクエストを送信し、目的の場所の PlaceResult.place_id を渡すことで、各場所の詳細な PlaceResult を取得できます。PlaceSearchPagination オブジェクトは、結果の追加ページの取得に使用できます(これが結果の最後のページである場合、または結果が 1 ページのみの場合は null)。
textSearch
textSearch(request, callback)
パラメータ: 
戻り値: なし
クエリ文字列(例: 「渋谷のピザ屋」、「渋谷付近の靴店」)に基づいて場所のリストを取得します。location パラメータは省略可能です。地域が指定されている場合、検索結果はエリア内の場所に制限されるのではなく、付近の検索結果のみに対してバイアスされます。任意の文字列を使用して場所を検索する場合や、検索結果を特定の場所に限定しない場合は、textSearch を使用します。PlaceSearchPagination オブジェクトは、結果の追加ページの取得に使用できます(これが結果の最後のページである場合、または結果が 1 ページのみの場合は null)。

PlaceDetailsRequest インターフェース

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

PlacesService に送信される場所の詳細クエリ。

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
Place の検索時に使用するバイアス。結果は指定された 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
Place の検索時に使用するバイアス。結果は指定された LocationBias に対してバイアスされますが、これに限定されません。

PlaceSearchRequest インターフェース

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

PlacesService に送信されるプレイス検索クエリ。

bounds optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
プレイスを検索する境界。bounds が設定されている場合、locationradius はどちらも無視されます。
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
結果を返すときに使用するランキング方式を指定します。rankByDISTANCE に設定されている場合、location を指定する必要がありますが、radius または bounds は指定できません。
type optional
タイプ:  string optional
指定されたタイプの場所を検索します。このタイプはリクエストの対象地域のローカル言語に翻訳され、クエリ文字列として使用されます。クエリも指定されている場合は、ローカライズされたタイプの文字列に連結されます。異なるタイプの結果はレスポンスから除外されます。このフィールドを使用して、言語と地域に依存しないカテゴリ検索を実行します。有効なタイプについてはこちらをご覧ください。

TextSearchRequest インターフェース

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

PlacesService に送信されるテキスト検索リクエスト。

bounds optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
プレイス検索の結果にバイアスをかけるために使用される境界(省略可)。bounds が設定されている場合、locationradius はどちらも無視されます。結果はこれらの境界内の結果に限定されませんが、範囲内の結果の方がランクが高くなります。
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()
パラメータ: なし
戻り値: なし
結果の次のページを取得します。最初の検索リクエストに対して指定されたものと同じコールバック関数を使用します。

PlaceResult インターフェース

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

プレイスに関する情報を定義します。

address_components optional
タイプ:  Array<GeocoderAddressComponent> optional
このプレイスの位置の住所コンポーネントのコレクション。PlacesService.getDetails でのみ使用できます。
adr_address optional
タイプ:  string optional
プレイスの住所を adr microformat で表したもの。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
このプレイスの結果に対して表示される属性テキスト。利用可能な html_attributions は、リクエストされた fields に関係なく常に返され、表示する必要があります。
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
場所の名前。注: ユーザーが「Places」と入力した場合、これはユーザーが入力した未加工のテキストです。悪意のあるユーザーがコード インジェクション攻撃のベクトルとして使用しようとする可能性があるため、このデータは慎重に使用してください( 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_offset660 になります。UTC より後のタイムゾーンの場合、オフセットは負になります。たとえば、カーボベルデの場合、utc_offset-60 です。PlacesService.getDetails でのみ使用できます。
utc_offset_minutes optional
タイプ:  number optional
プレイスの現在のタイムゾーンの UTC からのオフセット(分単位)。たとえば、オーストラリアのシドニーの夏時間は UTC より 11 時間進んでいるため、utc_offset_minutes660 になります。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
このプレイスを地図に表示する場合に優先されるビューポート。プレイスの優先されるビューポートが不明な場合、このプロパティは 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
各曜日の書式設定された営業時間を表す 7 つの文字列の配列。プレイス サービスは、現在の言語に合わせて営業時間を適切にフォーマットし、ローカライズします。この配列の要素の順番は言語によって異なります。1 週間が月曜日から始まる言語もあれば、日曜日から始まる言語もあります。PlacesService.getDetails でのみ使用できます。その他の呼び出しでは空の配列が返されることがあります。
isOpen
isOpen([date])
パラメータ: 
  • dateDate optional
戻り値:  boolean|undefined
その場所が現在営業しているか(日付が過ぎていない場合)か、指定した日付に営業しているかを確認します。この場所に PlaceResult.utc_offset_minutes または PlaceOpeningHours.periods が指定されていない場合、undefined が返されます(PlaceOpeningHours.periodsPlacesService.getDetails 経由でのみ利用可能です)。このメソッドでは、祝休日の営業時間などの例外的な営業時間は考慮されません。

PlaceOpeningHoursPeriod インターフェース

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

プレイスの営業時間に関する構造化された情報を定義します。注: 場所が常に営業している場合は、レスポンスに close セクションは含まれません。クライアントは、値が 0day と値 "0000"time を含み、close が含まれない open 期間として表される常時オープンを信頼できます。

open
場所の開店時間です。
close optional
タイプ:  PlaceOpeningHoursTime optional
場所の営業終了時間です。

PlaceOpeningHoursTime インターフェース

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

場所が開店または閉店するタイミングを定義します。

day
タイプ:  number
日曜日から始まる曜日。06 の範囲の数値で指定します。たとえば、2 は火曜日を示します。
hours
タイプ:  number
PlaceOpeningHoursTime.time の時間を数値で表し、[023] の範囲で指定します。この情報は、プレイスのタイムゾーンで報告されます。
minutes
タイプ:  number
PlaceOpeningHoursTime.time の分(059 の範囲の数値)。プレイスのタイムゾーンでレポートされます。
time
タイプ:  string
「hhmm」形式の 24 時間形式の時刻。値の範囲は ["0000""2359"] です。時刻は場所のタイムゾーンで報告されます。
nextDate optional
タイプ:  number optional
この PlaceOpeningHoursTime の次回発生を表すタイムスタンプ(エポックからのミリ秒数、new Date() での使用に適しています)。週の PlaceOpeningHoursTime.dayPlaceOpeningHoursTime.timePlaceResult.utc_offset_minutes から計算されます。PlaceResult.utc_offset_minutesundefined の場合、nextDateundefined になります。

PlacePlusCode インターフェース

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

プレイスの Open Location Code(コード: plus code)を定義します。Plus Codes は、番地がない場所(建物に番号が付いていない場所や、通りに名前がない場所)で、番地の代わりに使用できます。

global_code
タイプ:  string
次の 1/8,000 x 1/8,000 の領域を持つ plus code。例: "8FVC9G8F+5W"
compound_code optional
タイプ:  string optional
次数の 1/8,000 x 1/8,000 の次数を持つ plus code。最初の 4 文字(市外局番)が省略され、地域の説明に置き換えられます。たとえば、"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 インターフェース

場所に関する 1 件のクチコミを表します。

author_name
タイプ:  string
クチコミ投稿者の名前です。
language
タイプ:  string
このレビューが書かれた言語を示す IETF 言語コード。このコードにはメイン言語のタグのみが含まれ、国または地域を示すセカンダリタグは含まれていないことに注意してください。たとえば、英語のレビューはすべて、「en-AU」や「en-UK」ではなく 'en' としてタグ付けされます。
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 の数値)。