Place (beta)

Place クラス

google.maps.places.Place クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {Place} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

コンストラクタ
Place	Place(options) パラメータ: options: PlaceOptions

静的メソッド
findPlaceFromPhoneNumber	findPlaceFromPhoneNumber(request) パラメータ: request: FindPlaceFromPhoneNumberRequest電話番号とリクエストされたフィールドを含むリクエスト。 戻り値: Promise<{places:Array<Place>}> 指定された電話番号に基づいて場所を検索します。複数の場所で電話番号が共有される場合があるため、配列を返します。
findPlaceFromQuery	findPlaceFromQuery(request) パラメータ: request:  FindPlaceFromQueryRequest テキストクエリとリクエストされたフィールドを含むリクエスト。 戻り値: Promise<{places:Array<Place>}> 指定されたテキストクエリに基づいて場所を検索します。クエリがあいまいで、複数の場所が返されることがあるため、配列を返します。この方法は、複数の結果が期待される検索には適していません。

プロパティ
addressComponents	タイプ: Array<AddressComponent> optional この場所の場所の住所コンポーネントのコレクション。既知の住所データがない場合は空のオブジェクト。undefined: サーバーから住所データが呼び出されていない場合。
adrFormatAddress	タイプ: string optional adr microformat でのプレイスの住所の表現。
attributions	タイプ: Array<Attribution> optional この場所の結果に対して表示される属性テキスト。
businessStatus	タイプ: BusinessStatus optional ビジネスの運用状況。既知のステータスがない場合は、null。undefined: ステータス データがサーバーから読み込まれていない場合。
displayName	タイプ: string optional 場所の表示名。null（名前がない場合）。名前データがサーバーから読み込まれていない場合は undefined。
formattedAddress	タイプ: string optional ビジネスの完全な住所です。
googleMapsURI	タイプ: string optional この場所の公式 Google ページの URL です。これは、この場所について入手可能な最良の情報を含む Google のページです。
hasCurbsidePickup	タイプ: boolean optional 特定の店舗でのピックアップの有無。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
hasDelivery	タイプ: boolean optional 特定の場所が配達済みかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
hasDineIn	タイプ: boolean optional 場所にダイニングがあるかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
hasTakeout	タイプ: boolean optional テイクアウトの有無。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
hasWheelchairAccessibleEntrance	タイプ: boolean optional その場所に車椅子対応の入り口があるかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
icon	タイプ: string optional この場所のカテゴリを表すために使用できる画像リソースへの URL です。
iconBackgroundColor	タイプ: string optional 場所のカテゴリのデフォルトの 16 進数色コードです。
id	タイプ: string 一意の場所 ID。
internationalPhoneNumber	タイプ: string optional 国際電話形式の場所の電話番号。国際形式では、「+」記号と国コードが先頭に付きます。
isReservable	タイプ: boolean optional 場所が予約可能かどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
location	タイプ: LatLng optional 場所の位置。
nationalPhoneNumber	タイプ: string optional 電話番号の地域慣例に従ってフォーマットされた場所の電話番号。
openingHours	タイプ: OpeningHours optional
photos	タイプ: Array<Photo> optional この場所の写真。コレクションには最大 10 個の Photo オブジェクトが含まれます。
plusCode	タイプ: PlusCode optional
priceLevel	タイプ: number optional Place の価格レベル（0 ～ 4 のスケール）。価格レベルは次のように解釈されます。 0: 無料 1: 安い 2: 中程度 3: 高コスト 4: 非常に高い
rating	タイプ: number optional この場所のユーザー レビューに基づく 1.0 ～ 5.0 の評価。
requestedLanguage	タイプ: string optional この場所に関してリクエストされた言語です。
requestedRegion	タイプ: string optional この場所に対してリクエストされている地域です。
reviews	タイプ: Array<Review> optional この場所のクチコミのリスト。
servesBeer	タイプ: boolean optional ビールを提供しているかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
servesBreakfast	タイプ: boolean optional 朝食メニューを提供するかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
servesBrunch	タイプ: boolean optional ブランチを提供するかどうか値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
servesDinner	タイプ: boolean optional ディナーを提供するかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
servesLunch	タイプ: boolean optional ランチを提供するかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
servesVegetarianFood	タイプ: boolean optional ベジタリアン料理を提供するかどうか値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
servesWine	タイプ: boolean optional ある場所でワインを提供しているかどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合、未定義が返されます。
svgIconMaskURI	タイプ: string optional 場所のカテゴリを表すために使用できる svg イメージ マスク リソースの URI。
types	タイプ: Array<string> optional この場所の型の配列（["political", "locality"]、["restaurant", "establishment"] など）。
userRatingsCount	タイプ: number optional この場所の Place.rating のユーザーによる評価です。
utcOffsetMinutes	タイプ: number optional プレイスの現在のタイムゾーンの UTC からのオフセット（分単位）。たとえば、夏時間（オーストリア / 東部標準時（GMT+10）の場合）は UTC より 11 時間早いため、utc_offset_minutes は 660 になります。UTC より後のタイムゾーンの場合、オフセットは負になります。たとえば、カーボベルデの utc_offset_minutes は -60 です。
viewport	タイプ: LatLngBounds optional この場所を地図に表示するときの優先的なビューポート。
websiteURI	タイプ: string optional 会社のホームページなど、当該の場所の公式ウェブサイト。

Methods
fetchFields	fetchFields(options) パラメータ: options: FetchFieldsRequest 戻り値: Promise<{place:Place}>
getNextOpeningTime	getNextOpeningTime([date]) パラメータ: date:  Date optional 戻り値: Promise<Date optional> 次の OpeningHoursTime を表すタイムスタンプ（エポックからのミリ秒単位）を計算します。結果を計算するのに十分なデータがない場合、またはこの場所が稼働していない場合、未定義が返されます。
isOpen	isOpen([date]) パラメータ: date:  デフォルトは Date optional です。 戻り値: Promise<boolean optional> 指定した日時に営業しているかどうかを確認します。営業時間が登録されていない場合など、店舗の既知のデータが不十分な場合に undefined で解決されます。

PlaceOptions インターフェース

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

注意: v=beta チャンネルでのみ使用できます。

Place を構築するためのオプション。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
id	タイプ: string 一意の場所 ID。
requestedLanguage optional	タイプ: string optional 詳細を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
requestedRegion optional	タイプ: string optional ユーザーのリージョンの地域コード。これは、返される写真のほか、場合によっては他の写真にも影響します。地域コードは 2 文字の ccTLD（「トップレベル ドメイン」）を受け入れます。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、イギリスの ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（技術的には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ）です。

AddressComponent クラス

google.maps.places.AddressComponent クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {AddressComponent} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
longText	タイプ: string optional 住所コンポーネントの全文。
shortText	タイプ: string optional 指定された住所コンポーネントの省略形の短いテキスト。
types	タイプ: Array<string> この住所コンポーネントのタイプを示す文字列の配列です。有効なタイプの一覧については、こちらをご覧ください。

Attribution クラス

google.maps.places.Attribution クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {Attribution} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
provider	タイプ: string optional この場所の結果に対して表示される属性テキスト。
providerURI	タイプ: string optional

FetchFieldsRequest インターフェース

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

注意: v=beta チャンネルでのみ使用できます。

プレイス フィールドを取得するオプション。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
fields	タイプ: Array<string> 取得するフィールドのリスト。
sessionToken optional	タイプ: AutocompleteSessionToken optional 詳細リクエストをオートコンプリート セッションにバンドルするための一意のリファレンス。

OpeningHours クラス

google.maps.places.OpeningHours クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {OpeningHours} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
periods	タイプ: Array<OpeningHoursPeriod> 日曜日から始まる曜日を時系列で並べた期間。プレイスが営業していない日は含まれません。
weekdayDescriptions	タイプ: Array<string> 曜日ごとの書式設定された営業時間を表す 7 つの文字列の配列。プレイス サービスは、現在の言語に合わせて営業時間の表示形式とローカライズを行います。この配列内の要素の順番は、言語によって異なります。1 週間が月曜日から始まる言語もあれば、日曜日から始まる言語もあります。

OpeningHoursPeriod クラス

google.maps.places.OpeningHoursPeriod クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {OpeningHoursPeriod} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
close	タイプ: OpeningHoursPoint optional Place の営業終了時間です。
open	タイプ: OpeningHoursPoint 店舗の営業開始時間。

OpeningHoursPoint クラス

google.maps.places.OpeningHoursPoint クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {OpeningHoursPoint} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
day	タイプ: number 曜日。日曜日から始まる [0, 6] の範囲の数値。たとえば、2 は火曜日を示します。
hour	タイプ: number OpeningHoursPoint.time の時間（0 ～ 23 の範囲）。この場所のタイムゾーンで報告されます。
minute	タイプ: number OpeningHoursPoint.time の分（0 ～ 59 の範囲）。この場所のタイムゾーンで報告されます。

Photo クラス

google.maps.places.Photo クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {Photo} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
attributions	タイプ: Array<PhotoAttribution> この写真に表示される帰属テキスト。
heightPx	タイプ: number 写真の高さ（ピクセル単位）
widthPx	タイプ: number 写真の幅（ピクセル単位）

Methods
getURI	getURI([options]) パラメータ: options: PhotoOptions optional 戻り値: string 指定されたオプションに対応する画像 URL を返します。

PhotoAttribution クラス

google.maps.places.PhotoAttribution クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {PhotoAttribution} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
author	タイプ: string この写真結果に表示される帰属テキスト。
authorURI	タイプ: string optional

PlusCode クラス

google.maps.places.PlusCode クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {PlusCode} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
compoundCode	タイプ: string optional 1/8000 度から 1/8000 度までの Plus Code で、最初の 4 文字（市外局番）が地域限定の説明に置き換えられます。（例: 「9G8F+5W Zurich, Switzerland」）。
globalCode	タイプ: string optional 1/8000 度 / 1/8000 度を表す Plus Code。例: 「8FVC9G8F+5W」。

Review クラス

google.maps.places.Review クラス

注意: v=beta チャンネルでのみ使用できます。

&libraries=places URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {Review} = await google.map.importLibrary("places") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

プロパティ
author	タイプ: string optional クチコミ投稿者の名前。
authorPhotoURI	タイプ: string optional 収益者のプロフィール画像の URL。
authorURI	タイプ: string optional クチコミ投稿者のプロフィールの URL です。
publishTime	タイプ: Date optional
rating	タイプ: number optional このレビューの評価。1.0 ～ 5.0 の数値です。
relativePublishTimeDescription	タイプ: string optional 審査時刻を、現在の時刻を基準とする最近の時刻の形式の文字列。言語と国に適した形式で入力します。例: 「1 か月前」。
text	タイプ: string optional レビューのテキスト。
textLanguageCode	タイプ: string optional このレビューが書かれている言語を示す IETF 言語コード。このコードには、メインの言語タグのみが含まれます。国または地域を示す付随的なタグは含まれません。たとえば、英語のクチコミはすべて、「en-AU」や「en-UK」ではなく「'en'」としてタグ付けされます。