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)
パラメータ: 
戻り値: None
電話番号に基づいて、場所のリストを取得します。ほとんどの場合、結果リストに含まれる項目は 1 つのみですが、リクエストがあいまいな場合は、複数の結果が返されることがあります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリで PlacesService.getDetails を呼び出し、目的の場所について PlaceResult.place_id を渡すと、場所ごとに詳細な PlaceResult を取得できます。
findPlaceFromQuery
findPlaceFromQuery(request, callback)
パラメータ: 
戻り値: None
クエリ文字列に基づいて場所のリストを取得します。ほとんどの場合、結果リストに含まれる項目は 1 つのみですが、リクエストがあいまいな場合は、複数の結果が返されることがあります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリで PlacesService.getDetails を呼び出し、目的の場所について PlaceResult.place_id を渡すと、場所ごとに詳細な PlaceResult を取得できます。
getDetails
getDetails(request, callback)
パラメータ: 
戻り値: None
指定された placeId で識別される場所の詳細を取得します。
nearbySearch
nearbySearch(request, callback)
パラメータ: 
戻り値: None
キーワードまたはタイプに基づいて、特定の場所周辺の場所のリストを取得します。場所は、LatLngBounds、または location パラメータと radius パラメータのいずれかを渡して必ず指定する必要があります。コールバックに渡される PlaceResult は、完全な PlaceResult のサブセットです。アプリでは、Place Details リクエストを送信して、目的の場所の PlaceResult.place_id を渡すことで、各場所の詳細な PlaceResult を取得できます。PlaceSearchPagination オブジェクトを使用すると、結果の追加ページを取得できます(これが結果の最後のページである場合や、結果が 1 ページしかない場合は null になります)。
textSearch
textSearch(request, callback)
パラメータ: 
戻り値: None
クエリ文字列(「ニューヨークのピザ」や「オタワの靴店」など)に基づいて場所のリストを取得します。位置情報パラメータは省略可能です。位置情報を指定した場合、結果は、その地域内の場所に限定されず、近くにある結果に絞り込まれます。場所を特定して文字列を検索する場合や、検索結果を特定の場所に限定したくない場合は、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
ユーザーのリージョンの地域コード。これは、返される写真のほか、場合によっては他の写真にも影響します。地域コードは 2 文字の ccTLD(「トップレベル ドメイン」)を受け入れます。ほとんどの 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
結果にバイアスをかける地域コード。地域コードは 2 文字の ccTLD(「トップレベル ドメイン」)を受け入れます。ほとんどの 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()
パラメータ: なし
戻り値: None
結果の次のページを取得します。最初の検索リクエストに指定したのと同じコールバック関数を使用します。

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
場所の名前。注: ユーザーがプレイスを入力すると、ユーザーが入力した未加工テキストになります。悪意のあるユーザーがコードをコード インジェクション攻撃のベクトルとして利用しようとする可能性があるため、ご注意ください。 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
店舗の営業場所コードまたは「plus code」を定義します。
price_level optional
タイプ:  number optional
Place の価格レベル(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
Place のタイプの配列(["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 のシドニー オフィスの付近の値は "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
Place の営業終了時間です。

PlaceOpeningHoursTime インターフェース

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

プレイスが開いたり閉じたりするタイミングを定義します。

day
タイプ:  number
曜日。0 から 6 までの数値で表され、日曜日から始まる。たとえば、2 は火曜日を示します。
hours
タイプ:  number
PlaceOpeningHoursTime.time の営業時間(0 または 23 の範囲)です。これは場所のタイムゾーンで報告されます。
minutes
タイプ:  number
分(059)の数値(分)。これは PlaceOpeningHoursTime.time のタイムゾーンで報告されます。
time
タイプ:  string
24 時間形式の「hhmm」形式の時刻。値の範囲は ["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 インターフェース

プレイスのオープン ロケーション コード(「plus code」)を定義します。Plus Codes は、番地がない場所(建物に番号が付いていない場所や、通りに名前がない場所)で、番地の代わりに使用できます。

global_code
タイプ:  string
学位の 1/8000 度から 1/8000 度までのプラスコード。例: "8FVC9G8F+5W"
compound_code optional
タイプ:  string optional
1/8,000 度または 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 つの場所について 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 の数値です。