Places Service

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

PlacesService クラス

google.maps.places.PlacesService クラス

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

&libraries=places URL パラメータが必要です。詳しくは、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 のサブセットです。アプリで Place Details リクエストを送信して、目的の場所の PlaceResult.place_id を渡すと、場所ごとの詳細な PlaceResult を取得できます。PlaceSearchPagination オブジェクトは、追加の結果ページを取得するために使用できます(これが最後の結果ページである場合や、結果が 1 ページのみの場合は null になります)。
textSearch
textSearch(request, callback)
パラメータ:
戻り値: なし
クエリ文字列に基づいて場所のリストを取得します(例: 「New York in NY」のピザ、「Ottawa の近くの靴屋」)。location パラメータは省略可能です。指定した場合、検索結果はエリア内の場所に限定されるのではなく、付近の検索結果のみに基づいて決まります。任意の文字列で場所を検索したい場合や、検索結果を特定の場所に制限したくない場合は、textSearch を使用します。PlaceSearchPagination オブジェクトは、追加の結果ページを取得するために使用できます(これが最後の結果ページである場合や、結果が 1 ページのみの場合は null になります)。

PlaceDetailsRequest インターフェース

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

PlacesService に送信される Place Details クエリ。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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 は .co.uk で、ISO 3166-1 コードは「gb」です。
sessionToken optional
タイプ: AutocompleteSessionToken optional
詳細リクエストをオートコンプリート セッションにバンドルするために使用される一意の参照。

FindPlaceFromPhoneNumberRequest インターフェース

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

PlacesService.findPlaceFromPhoneNumber に送信されるテキスト検索リクエストからの Find Place。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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 に送信されるテキスト検索リクエストからの Find Place。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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

PlaceSearchRequest インターフェース

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

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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 に送信されるテキスト検索リクエスト。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

bounds optional
タイプ: LatLngBounds|LatLngBoundsLiteral optional
Places の検索時に結果をバイアスするために使用される境界(省略可)。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 は .co.uk で、ISO 3166-1 コードは「gb」です。
type optional
タイプ: string optional
指定されたタイプの場所の検索。タイプはリクエストの地域の言語に翻訳され、クエリ文字列として使用されます。クエリも指定されている場合は、ローカライズされたタイプの文字列に連結されます。別のタイプの結果はレスポンスから除外されます。このフィールドを使用すると、言語と地域に依存しないカテゴリ検索を実行できます。有効なタイプについては、こちらをご覧ください。

RankBy 定数

google.maps.places.RankBy 定数

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

DISTANCE 場所の所在地からの距離でランク付けされます。
PROMINENCE ランキングは知名度に基づいて決定されます。

LocationBias typedef

google.maps.places.LocationBiastypedef

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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

LocationRestriction typedef

google.maps.places.LocationRestrictiontypedef

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus 定数

google.maps.places.PlacesServiceStatus 定数

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

INVALID_REQUEST リクエストが無効です。
NOT_FOUND 参照された場所が見つかりませんでした。
OK 有効な結果がレスポンスに含まれています。
OVER_QUERY_LIMIT アプリケーションがリクエストの割り当てを超過しました。
REQUEST_DENIED アプリケーションで PlacesService を使用することはできません。
UNKNOWN_ERROR サーバーエラーのため、PlacesService リクエストを処理できませんでした。再度リクエストすると、成功する可能性があります。
ZERO_RESULTS このリクエストに対する結果は見つかりませんでした。

PlaceSearchPagination インターフェース

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

プレイス結果の追加ページを取得するために使用するオブジェクト。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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

PlaceResult インターフェース

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

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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
この場所の結果に対して表示される属性テキスト。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
ビジネスのオープン ロケーション コード(または 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
この場所のタイプの配列(["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 からのオフセット(分)。たとえば、オーストラリアのシドニーは夏時間よりも 11 時間早く、つまり utc_offset660 になります。UTC より後のタイムゾーンの場合、オフセットは負になります。たとえば、utc_offset がカーボベルデでは -60 になります。PlacesService.getDetails でのみ利用できます。
utc_offset_minutes optional
タイプ: number optional
プレイスの現在のタイムゾーンの UTC からのオフセット(分)。たとえば、オーストラリアのシドニーは夏時間よりも 11 時間早く、つまり utc_offset_minutes660 になります。UTC より後のタイムゾーンの場合、オフセットは負になります。たとえば、utc_offset_minutes がカーボベルデでは -60 になります。PlacesService.getDetails でのみ利用できます。
vicinity optional
タイプ: string optional
場所の簡単な住所です。番地や市町村などが含まれ、州、都道府県、郵便番号、国などは含まれません。たとえば、オーストラリアにあるシドニーのオフィスのコンバージョン値は "48 Pirrama Road, Pyrmont" になります。PlacesService.getDetails でのみ利用できます。
website optional
タイプ: string optional
ビジネスの公式ホームページなど、この場所の公式ウェブサイト。PlacesService.getDetails でのみ利用できます。

PlaceAspectRating インターフェース

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

ユーザーがクチコミを投稿した場所の一面に関する情報を定義します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

rating
タイプ: number
この側面の評価。個々のレビューの場合、これは 0 ~ 3 の整数です。場所の総合評価の場合、これは 0 ~ 30 の整数です。
type
タイプ: string
アスペクト比のタイプ。例: "food""decor""service"、または "overall"

BusinessStatus 定数

google.maps.places.BusinessStatus 定数

Place の営業ステータスです。お店やサービスの場合は、PlaceResult に返されます(その場所が営業しているか、臨時休業または閉業しているかを示します)。これらの値または定数名('OPERATIONAL'google.maps.places.BusinessStatus.OPERATIONAL など)で指定します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

CLOSED_PERMANENTLY ビジネスは閉業しています。
CLOSED_TEMPORARILY ビジネスは臨時休業しています。
OPERATIONAL ビジネスは正常に動作しています。

PlaceGeometry インターフェース

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

プレイスのジオメトリに関する情報を定義します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

location optional
タイプ: LatLng optional
プレイスの位置。
viewport optional
タイプ: LatLngBounds optional
この場所を地図に表示する際の優先ビューポートです。プレイスの優先ビューポートが不明な場合、このプロパティは null になります。PlacesService.getDetails でのみ利用できます。

PlaceOpeningHours インターフェース

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

プレイスの営業時間に関する情報を定義します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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 セクションは含まれません。クライアントは、day が値 0time が値 "0000" であり、close を含まない open 期間として表されます。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

open
Place の開始時刻です。
close optional
タイプ: PlaceOpeningHoursTime optional
Place の営業終了時間。

PlaceOpeningHoursTime インターフェース

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

プレイスがいつオープンまたはクローズするかを定義します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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.dayPlaceOpeningHoursTime.timePlaceResult.utc_offset_minutes から計算されます。PlaceResult.utc_offset_minutesundefined の場合、nextDateundefined になります。

PlacePlusCode インターフェース

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

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

global_code
タイプ: string
1/8,000 度または 1/8000 度の面積の plus code。例: "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 インターフェース

Place の写真要素を表します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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

PhotoOptions インターフェース

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

写真のリクエスト方法を定義します。

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

maxHeight optional
タイプ: number optional
返される画像の最大の高さ(ピクセル単位)。
maxWidth optional
タイプ: number optional
返される画像の最大幅(ピクセル単位)。

PlaceReview インターフェース

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

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

&libraries=places URL パラメータが必要です。詳しくは、Maps JavaScript API のライブラリをご覧ください。

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 の数値です。