Place (beta)

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

Place クラス

google.maps.places.Place クラス

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

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

Place
Place(options)
パラメータ:
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
パラメータ:
戻り値: Promise<{places:Array<Place>}>
指定された電話番号に基づいて場所を検索します。複数の場所で電話番号が共有される場合があるため、配列を返します。
findPlaceFromQuery
findPlaceFromQuery(request)
パラメータ:
  • requestFindPlaceFromQueryRequest テキストクエリとリクエストされたフィールドを含むリクエスト。
戻り値: Promise<{places:Array<Place>}>
指定されたテキストクエリに基づいて場所を検索します。クエリがあいまいで、複数の場所が返されることがあるため、配列を返します。この方法は、複数の結果が期待される検索には適していません。
addressComponents
タイプ: Array<AddressComponent> optional
この場所の場所の住所コンポーネントのコレクション。既知の住所データがない場合は空のオブジェクト。undefined: サーバーから住所データが呼び出されていない場合。
adrFormatAddress
タイプ: string optional
adr microformat でのプレイスの住所の表現。
attributions
タイプ: Array<Attribution> optional
この場所の結果に対して表示される属性テキスト。
businessStatus
タイプ: BusinessStatus optional
ビジネスの運用状況。既知のステータスがない場合は、nullundefined: ステータス データがサーバーから読み込まれていない場合。
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_minutes660 になります。UTC より後のタイムゾーンの場合、オフセットは負になります。たとえば、カーボベルデの utc_offset_minutes-60 です。
viewport
タイプ: LatLngBounds optional
この場所を地図に表示するときの優先的なビューポート。
websiteURI
タイプ: string optional
会社のホームページなど、当該の場所の公式ウェブサイト。
fetchFields
fetchFields(options)
パラメータ:
戻り値: Promise<{place:Place}>
getNextOpeningTime
getNextOpeningTime([date])
パラメータ:
  • dateDate optional
戻り値: Promise<Date optional>
次の OpeningHoursTime を表すタイムスタンプ(エポックからのミリ秒単位)を計算します。結果を計算するのに十分なデータがない場合、またはこの場所が稼働していない場合、未定義が返されます。
isOpen
isOpen([date])
パラメータ:
  • date:  デフォルトは Date optional です。
戻り値: Promise<boolean optional>
指定した日時に営業しているかどうかを確認します。営業時間が登録されていない場合など、店舗の既知のデータが不十分な場合に undefined で解決されます。

PlaceOptions インターフェース

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

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 クラス

&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 クラス

&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 インターフェース

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

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

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

OpeningHours クラス

google.maps.places.OpeningHours クラス

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

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

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

OpeningHoursPeriod クラス

google.maps.places.OpeningHoursPeriod クラス

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

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

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

OpeningHoursPoint クラス

google.maps.places.OpeningHoursPoint クラス

&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 クラス

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

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

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

PhotoAttribution クラス

google.maps.places.PhotoAttribution クラス

&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 クラス

&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 クラス

&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'」としてタグ付けされます。