Place (beta)

Place クラス

google.maps.places.Place クラス

const {Place} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
Place
Place(options)
パラメータ: 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
パラメータ: 
戻り値:  Promise<{places:Array<Place>}>
指定された電話番号で場所を検索します。複数の場所が 1 つの電話番号を共有することができるまれなケースのために、配列を返します。
BetafindPlaceFromQuery
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」を返します。このフィールドがまだリクエストされていない場合は、「未定義」を返します。
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
タイプ:  PriceLevel optional
Place の料金レベル。このプロパティは次のいずれかの値を返すことができます。
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
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"] など）の配列です。
userRatingCount
タイプ:  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
お店やサービスのホームページなど、当該の場所の公式ウェブサイト。
BetafetchFields
fetchFields(options)
パラメータ: 
戻り値:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
パラメータ: 
  • date:  Date optional
戻り値:  Promise<Date optional>
次の OpeningHoursTime を表す日付を計算します。結果を計算するのに十分なデータがない場合やこの場所が営業していない場合は、未定義を返します。
BetaisOpen
isOpen([date])
パラメータ: 
  • date:  Date optional。現在はデフォルト値。
戻り値:  Promise<boolean optional>
指定した日時に営業しているかどうかを確認します。営業時間が未登録の場合など、場所の既知のデータで解決できない場合は undefined で解決されます。
toJSON
toJSON()
パラメータ: なし
戻り値:  Object は、リクエストされたすべてのプレイス プロパティを含む JSON オブジェクトです。

PlaceOptions インターフェース

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

場所を作成するためのオプション。
id
タイプ:  string
一意の場所 ID。
requestedLanguage optional
タイプ:  string optional
詳細を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
requestedRegion optional
タイプ:  string optional
ユーザーの地域の地域コード。これは、返される写真だけでなく、他の写真にも影響を与える可能性があります。地域コードは ccTLD（「トップレベル ドメイン」）の 2 文字の値を受け付けます。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密にはイギリスと北アイルランドのエンティティ）です。

AddressComponent クラス

google.maps.places.AddressComponent クラス

const {AddressComponent} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
longText
タイプ:  string optional
住所コンポーネントの全文。
shortText
タイプ:  string optional
指定された住所コンポーネントの略称テキスト。
types
タイプ:  Array<string>
この住所コンポーネントのタイプを示す文字列の配列。有効なタイプのリストについては、こちらをご覧ください。

アトリビューション クラス

google.maps.places.Attribution クラス

const {Attribution} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
provider
タイプ:  string optional
この場所の結果に対して表示される属性テキスト。
providerURI
タイプ:  string optional

FetchFieldsRequest インターフェース

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

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

OpeningHours クラス

google.maps.places.OpeningHours クラス

const {OpeningHours} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
periods
曜日は、日曜日から開始して曜日順に表示されます。営業していない日は含まれません。
weekdayDescriptions
タイプ:  Array<string>
曜日ごとに書式設定された営業時間を表す 7 つの文字列の配列。営業時間は、Places Service によって現在の言語に合わせてフォーマットされ、ローカライズされます。この配列内の要素の順番は言語によって異なります。1 週間が月曜日から始まる言語もあれば、日曜日から始まる言語もあります。

OpeningHoursPeriod クラス

google.maps.places.OpeningHoursPeriod クラス

const {OpeningHoursPeriod} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
close
タイプ:  OpeningHoursPoint optional
場所の営業終了時間。
open
タイプ:  OpeningHoursPoint
場所の開始時刻。

OpeningHoursPoint クラス

google.maps.places.OpeningHoursPoint クラス

const {OpeningHoursPoint} = await google.maps.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 クラス

const {Photo} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
authorAttributions
タイプ:  Array<AuthorAttribution>
この写真に表示する帰属テキスト。
heightPx
タイプ:  number
写真の高さ（ピクセル単位）
widthPx
タイプ:  number
写真の幅（ピクセル単位）
getURI
getURI([options])
パラメータ: 
戻り値:  string
指定されたオプションに対応する画像の URL を返します。

AuthorAttribution クラス

google.maps.places.AuthorAttribution クラス

const {AuthorAttribution} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
displayName
タイプ:  string
この結果の作成者の名前。
photoURI
タイプ:  string optional
この結果の投稿者の写真 URI常に利用できるとは限りません。
uri
タイプ:  string optional
この結果の作成者のプロフィール URI。

PlusCode クラス

google.maps.places.PlusCode クラス

const {PlusCode} = await google.maps.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 クラス

const {Review} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
authorAttribution
タイプ:  AuthorAttribution optional
審査担当者。
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' とタグ付けされます。

PriceLevel 定数

google.maps.places.PriceLevel 定数

Place オブジェクトの価格水準の列挙型。

const {PriceLevel} = await google.maps.importLibrary("places") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE