Place Data

Place クラス

google.maps.places.Place クラス

このクラスは PlaceOptions を実装します。

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

Place
Place(options)
パラメータ: 
searchByText
searchByText(request)
パラメータ: 
戻り値:  Promise<{places:Array<Place>}>
テキストクエリに基づく Place Search。
searchNearby
searchNearby(request)
パラメータ: 
戻り値:  Promise<{places:Array<Place>}>
付近の場所を検索する。
accessibilityOptions
タイプ:  AccessibilityOptions optional
この場所のバリアフリー オプション。ユーザー補助オプションのデータがサーバーから呼び出されていない場合は undefined。
addressComponents
タイプ:  Array<AddressComponent> optional
この場所の住所コンポーネントのコレクション。既知の住所データがない場合は空のオブジェクト。サーバーからアドレスデータが呼び出されていない場合は undefined。
adrFormatAddress
タイプ:  string optional
adr マイクロフォーマットでの場所の住所の表現。
allowsDogs
タイプ:  boolean optional
attributions
タイプ:  Array<Attribution> optional
プレイスに表示する必要があるデータ プロバイダ。
businessStatus
タイプ:  BusinessStatus optional
ビジネス拠点の営業状況。既知のステータスがない場合は null。ステータス データがサーバーから読み込まれていない場合は undefined。
consumerAlert
タイプ:  ConsumerAlert optional
この場所に関する消費者アラート。
displayName
タイプ:  string optional
ビジネスの表示名。名前がない場合は null。名前データがサーバーから読み込まれていない場合は undefined。
displayNameLanguageCode
タイプ:  string optional
ビジネスの表示名の言語。名前がない場合は null。名前データがサーバーから読み込まれていない場合は undefined。
editorialSummary
タイプ:  string optional
この場所の編集要約。null(編集者による概要がない場合)。undefined(このフィールドがまだリクエストされていない場合)。
editorialSummaryLanguageCode
タイプ:  string optional
この場所の編集要約の言語。null(編集者による概要がない場合)。undefined(このフィールドがまだリクエストされていない場合)。
evChargeAmenitySummary
タイプ:  EVChargeAmenitySummary optional
この場所の EVChargeAmenitySummary。
evChargeOptions
タイプ:  EVChargeOptions optional
その場所で利用できる EV 充電オプション。undefined(EV 充電オプションがサーバーから呼び出されていない場合)。
formattedAddress
タイプ:  string optional
対象地域の完全な住所。
fuelOptions
タイプ:  FuelOptions optional
場所が提供する燃料オプション。undefined(燃料オプションがサーバーから呼び出されていない場合)。
generativeSummary
タイプ:  GenerativeSummary optional
この場所の GenerativeSummary。
googleMapsURI
タイプ:  string optional
この場所の公式 Google ページの URL。これは、この場所について入手可能な最良の情報を含む Google のページです。
hasCurbsidePickup
タイプ:  boolean optional
場所でピックアップが提供されているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
hasDelivery
タイプ:  boolean optional
宅配サービスがあるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
hasDineIn
タイプ:  boolean optional
イートインを利用できるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
hasLiveMusic
タイプ:  boolean optional
hasMenuForChildren
タイプ:  boolean optional
hasOutdoorSeating
タイプ:  boolean optional
hasRestroom
タイプ:  boolean optional
hasTakeout
タイプ:  boolean optional
テイクアウトに対応しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
iconBackgroundColor
タイプ:  string optional
場所のカテゴリのデフォルトの 16 進数色コード。
id
タイプ:  string
一意のプレイス ID。
internationalPhoneNumber
タイプ:  string optional
場所の国際電話形式の電話番号。国際形式では、「+」記号と国コードが先頭に付きます。
isGoodForChildren
タイプ:  boolean optional
isGoodForGroups
タイプ:  boolean optional
isGoodForWatchingSports
タイプ:  boolean optional
isReservable
タイプ:  boolean optional
場所が予約可能かどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
location
タイプ:  LatLng optional
場所の位置。
nationalPhoneNumber
タイプ:  string optional
電話番号の地域慣例に従ってフォーマットされた場所の電話番号。
neighborhoodSummary
タイプ:  NeighborhoodSummary optional
この場所の NeighborhoodSummary。
parkingOptions
タイプ:  ParkingOptions optional
その場所で提供されている駐車場のオプション。undefined(駐車オプションのデータがサーバーから呼び出されていない場合)。
paymentOptions
タイプ:  PaymentOptions optional
その場所で利用できるお支払いオプション。お支払いオプションのデータがサーバーから呼び出されていない場合は undefined。
photos
タイプ:  Array<Photo> optional
この場所の写真。コレクションには最大 10 個の Photo オブジェクトが含まれます。
plusCode
タイプ:  PlusCode optional
postalAddress
タイプ:  PostalAddress optional
priceLevel
タイプ:  PriceLevel optional
場所の価格レベル。このプロパティは、次のいずれかの値を返すことができます。
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
priceRange
タイプ:  PriceRange optional
この場所の価格帯。endPrice は未設定にできます。これは、上限のない範囲(「$100 超」など)を示します。
primaryType
タイプ:  string optional
ビジネスのメインのカテゴリ。タイプがない場合は null。undefined(タイプデータがサーバーから読み込まれていない場合)。
primaryTypeDisplayName
タイプ:  string optional
ビジネスのメインのタイプの表示名。タイプがない場合は null。undefined(タイプデータがサーバーから読み込まれていない場合)。
primaryTypeDisplayNameLanguageCode
タイプ:  string optional
ビジネスのメインのタイプの表示名の言語。タイプがない場合は null。undefined(タイプデータがサーバーから読み込まれていない場合)。
rating
タイプ:  number optional
この場所に関するユーザーのクチコミに基づく評価(1.0 ~ 5.0)。
regularOpeningHours
タイプ:  OpeningHours optional
requestedLanguage
タイプ:  string optional
この場所のリクエストされた言語。
requestedRegion
タイプ:  string optional
この場所のリクエストされたリージョン。
resourceName
タイプ:  string
一意の場所リソース名。
reviews
タイプ:  Array<Review> optional
この場所のクチコミのリスト。
reviewSummary
タイプ:  ReviewSummary optional
この場所の ReviewSummary。
servesBeer
タイプ:  boolean optional
ビールを提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
servesBreakfast
タイプ:  boolean optional
朝食を提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
servesBrunch
タイプ:  boolean optional
ブランチを提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
servesCocktails
タイプ:  boolean optional
servesCoffee
タイプ:  boolean optional
servesDessert
タイプ:  boolean optional
servesDinner
タイプ:  boolean optional
ディナーを提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
servesLunch
タイプ:  boolean optional
ランチを提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
servesVegetarianFood
タイプ:  boolean optional
ベジタリアン料理を提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
servesWine
タイプ:  boolean optional
ワインを提供しているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「undefined」を返します。
shortFormattedAddress
タイプ:  string optional
ビジネス拠点の短い住所。
subDestinations
タイプ:  Array<Place> optional
この場所のサブ目的地のリスト。サブ目的地は、メインの場所に関連付けられた特定の場所です。これにより、空港、国立公園、大学、スタジアムなど、広大で複雑な場所を検索しているユーザーに、より具体的な目的地を提示できます。
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
会社のホームページなど、当該の場所の公式ウェブサイト。
openingHours
タイプ:  OpeningHours optional
hasWiFi
タイプ:  boolean optional
fetchFields
fetchFields(options)
パラメータ: 
戻り値:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
パラメータ: 
  • date:  Date optional
戻り値:  Promise<Date optional>
場所の Place.regularOpeningHours を使用して、次の開店時間の Date を計算します。結果を計算するのに十分なデータがない場合、またはこの場所が営業していない場合は、undefined を返します。
BetaisOpen
isOpen([date])
パラメータ: 
  • date:  Date optional デフォルトは現在です。
戻り値:  Promise<boolean optional>
指定された Date に場所が営業しているかどうかを確認します。場所に関する既知のデータが不十分で計算できない場合(営業時間が登録されていない場合など)は、undefined で解決されます。
toJSON
toJSON()
パラメータ: なし
戻り値:  Object リクエストされたすべての Place プロパティを含む JSON オブジェクト。

PlaceOptions インターフェース

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

Place を作成するためのオプション。

id optional
タイプ:  string optional
一意のプレイス ID。
requestedLanguage optional
タイプ:  string optional
詳細を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。
requestedRegion optional
タイプ:  string optional
ユーザーの地域の地域コード。これにより、返される写真やその他の要素に影響する可能性があります。地域コードには、ccTLD(「トップレベル ドメイン」)の 2 文字の値を指定できます。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」(.co.uk)ですが、ISO 3166-1 コードは「gb」です(厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ)。
resourceName optional
タイプ:  string optional
一意の場所リソース名。

AccessibilityOptions クラス

google.maps.places.AccessibilityOptions クラス

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

hasWheelchairAccessibleEntrance
タイプ:  boolean optional
車椅子対応の入り口があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasWheelchairAccessibleParking
タイプ:  boolean optional
車椅子対応の駐車場があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasWheelchairAccessibleRestroom
タイプ:  boolean optional
車椅子対応のトイレがあるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasWheelchairAccessibleSeating
タイプ:  boolean optional
車椅子対応の座席があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。

AddressComponent クラス

google.maps.places.AddressComponent クラス

場所の住所コンポーネント。

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

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

Attribution クラス

google.maps.places.Attribution クラス

場所のデータ プロバイダに関する情報。

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

provider
タイプ:  string optional
場所のデータ プロバイダの名前。
providerURI
タイプ:  string optional
場所のデータ プロバイダの URI。

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。

ConnectorAggregation クラス

google.maps.places.ConnectorAggregation クラス

EV 充電情報。同じタイプのコネクタと同じ充電レートで集計されます。

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

availabilityLastUpdateTime
タイプ:  Date optional
この集計のコネクタの可用性情報が最後に更新された時刻。
availableCount
タイプ:  number optional
この集計で現在使用可能なコネクタの数。
count
タイプ:  number
この集計に含まれるコネクタの数。
maxChargeRateKw
タイプ:  number
集約の各コネクタの静的な最大充電率(kW)。
outOfServiceCount
タイプ:  number optional
この集計に含まれるコネクタのうち、現在サービスが停止しているコネクタの数。
type
タイプ:  EVConnectorType optional
この集計のコネクタタイプ。

ConsumerAlert クラス

google.maps.places.ConsumerAlert クラス

消費者アラート メッセージ。すべてのテキストは、languageCode フィールドで指定された言語でレンダリングされます。

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

details
タイプ:  ConsumerAlertDetails optional
消費者アラート メッセージの詳細。
languageCode
タイプ:  string optional
消費者アラート メッセージの言語コード。
overview
タイプ:  string optional
消費者アラート メッセージの概要。

ConsumerAlertDetails クラス

google.maps.places.ConsumerAlertDetails クラス

消費者アラート メッセージの詳細。

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

aboutLinkTitle
タイプ:  string optional
詳細情報を提供するリンクに表示するタイトル。
aboutLinkURI
タイプ:  string optional
詳細情報を提供するリンクの URI。
description
タイプ:  string optional
消費者アラート メッセージの説明。
title
タイプ:  string optional
詳細な説明とともに表示するタイトル。

ContentBlock クラス

google.maps.places.ContentBlock クラス

ContentBlock は、要約の内容とそのソースを記述します。

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

content
タイプ:  string optional
トピックに関連するコンテンツ。
contentLanguageCode
タイプ:  string optional
コンテンツの言語コード。
referencedPlaces
タイプ:  Array<Place>
参照される Place のリスト。最初に取得されたとき、各 Place の id フィールドにはプレイス ID のみが含まれます。

EVChargeAmenitySummary クラス

google.maps.places.EVChargeAmenitySummary クラス

EV 充電スタンド付近の設備に関する AI 生成の要約。これは、タイプが electric_vehicle_charging_station の場所にのみ適用されます。

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

coffee
タイプ:  ContentBlock optional
近くのコーヒー ショップの概要。
disclosureText
タイプ:  string optional
この概要に関連する開示のテキスト。
disclosureTextLanguageCode
タイプ:  string optional
開示テキストの言語コード。
flagContentURI
タイプ:  string optional
概要に関する問題を報告するための URI。
overview
タイプ:  ContentBlock optional
利用可能な設備の概要。
restaurant
タイプ:  ContentBlock optional
近くのレストランの概要。
store
タイプ:  ContentBlock optional
付近の店舗の概要。

EVChargeOptions クラス

google.maps.places.EVChargeOptions クラス

その場所に設置されている EV 充電スタンドに関する情報。

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

connectorAggregations
同じタイプと同じ充電率のコネクタを含む EV 充電コネクタの集計のリスト。
connectorCount
タイプ:  number
このステーションのコネクタの数。一部のポートには複数のコネクタがありますが、一度に充電できる車は 1 台のみであるため、コネクタの数は同時に充電できる車の総数よりも多くなる場合があります。

EVConnectorType 定数

google.maps.places.EVConnectorType 定数

EV 充電コネクタの種類。

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

CCS_COMBO_1 Combined Charging System(AC および DC)。SAE Type-1 J-1772 コネクタに基づいています。
CCS_COMBO_2 Combined Charging System(AC および DC)。Type-2 Mennekes コネクタをベースにしています。
CHADEMO CHAdeMO タイプのコネクタ。
J1772 J1772 タイプ 1 コネクタ。
NACS 北米充電規格(NACS)。SAE J3400 として標準化されています。
OTHER その他のコネクタタイプ。
TESLA 一般的な TESLA コネクタ。これは北米では NACS ですが、世界の他の地域では NACS 以外(CCS Combo 2(CCS2)や GB/T など)の場合があります。この値は、実際のコネクタタイプを表すというよりも、テスラが所有する充電ステーションでテスラ ブランドの車両を充電できることを表します。
TYPE_2 IEC 62196 タイプ 2 コネクタ。MENNEKES と呼ばれることもあります。
UNSPECIFIED_GB_T GB/T タイプは、中国の GB/T 規格に対応しています。このタイプは、すべての GB_T タイプを対象としています。
UNSPECIFIED_WALL_OUTLET コンセントが指定されていません。

EVSearchOptions インターフェース

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

Place Search リクエストに指定できる EV 関連のオプション。

connectorTypes optional
タイプ:  Array<EVConnectorType> optional
優先する EV コネクタの種類のリスト。リストされているコネクタタイプをサポートしていない場所は除外されます。
minimumChargingRateKw optional
タイプ:  number optional
必要な最小充電速度(kW)。充電速度が指定した速度未満の場所は除外されます。

FetchFieldsRequest インターフェース

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

Place フィールドを取得するためのオプション。

fields
タイプ:  Array<string>
取得するフィールドのリスト。

FuelOptions クラス

google.maps.places.FuelOptions クラス

ガソリン スタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。

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

fuelPrices
タイプ:  Array<FuelPrice>
このステーションが提供する燃料の種類ごとの燃料価格のリスト。燃料の種類ごとに 1 つのエントリ。

FuelPrice クラス

google.maps.places.FuelPrice クラス

特定の種類の燃料の価格情報。

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

price
タイプ:  Money optional
燃料の価格。
type
タイプ:  FuelType optional
燃料の種類。
updateTime
タイプ:  Date optional
燃料価格が最後に更新された時刻。

FuelType 定数

google.maps.places.FuelType 定数

燃料の種類。

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

BIO_DIESEL バイオディーゼル。
DIESEL ディーゼル燃料。
DIESEL_PLUS ディーゼル プラス燃料。
E100 E 100.
E80 E 80.
E85 E 85.
LPG LPG。
METHANE メタン。
MIDGRADE 中間グレード。
PREMIUM プレミアム。
REGULAR_UNLEADED レギュラー無鉛ガソリン。
SP100 SP 100。
SP91 SP 91。
SP91_E10 SP 91 E10。
SP92 SP 92.
SP95 SP 95。
SP95_E10 SP95 E10。
SP98 SP 98。
SP99 SP 99。
TRUCK_DIESEL トラック用ディーゼル。

GenerativeSummary クラス

google.maps.places.GenerativeSummary クラス

AI 生成による場所の要約。

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

disclosureText
タイプ:  string optional
この概要に関連する開示のテキスト。
disclosureTextLanguageCode
タイプ:  string optional
開示テキストの言語コード。
flagContentURI
タイプ:  string optional
概要に関する問題を報告するための URI。
overview
タイプ:  string optional
場所の概要。
overviewLanguageCode
タイプ:  string optional
概要の言語コード。

google.maps.places.GoogleMapsLinks クラス

Google マップのさまざまなアクションをトリガーするリンク。

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

directionsURI
タイプ:  string optional
Google マップでその場所へのルートを表示するためのリンク。このリンクでは、目的地の場所のみが入力され、デフォルトの移動手段 DRIVE が使用されます。
photosURI
タイプ:  string optional
Google マップでその場所の写真を表示するためのリンク。
placeURI
タイプ:  string optional
Google マップで場所を表示するためのリンク。
reviewsURI
タイプ:  string optional
Google マップで場所のクチコミを表示するためのリンク。
writeAReviewURI
タイプ:  string optional
Google マップでその場所のクチコミを投稿するためのリンク。

Money クラス

google.maps.places.Money クラス

金額を該当の通貨タイプで表します。

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

currencyCode
タイプ:  string
ISO 4217 で定義されている 3 文字の通貨コード。
nanos
タイプ:  number
金額のナノ単位(10 のマイナス 9 乗)の数。
units
タイプ:  number
金額の整数部分。たとえば、Money.currencyCode が「USD」の場合、1 単位は 1 米ドルです。
toString
toString()
パラメータ: なし
戻り値:  string
金額を、通貨記号付きの人が読める形式で返します。

NeighborhoodSummary クラス

google.maps.places.NeighborhoodSummary クラス

場所の近くにあるスポットの AI 生成の概要。

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

description
タイプ:  ContentBlock optional
近隣地域の詳細な説明。
disclosureText
タイプ:  string optional
この概要に関連する開示のテキスト。
disclosureTextLanguageCode
タイプ:  string optional
開示テキストの言語コード。
flagContentURI
タイプ:  string optional
概要に関する問題を報告するための URI。
overview
タイプ:  ContentBlock optional
近隣の概要。

OpeningHours クラス

google.maps.places.OpeningHours クラス

場所の営業時間に関する情報。

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

periods
日曜日から始まる各曜日を時系列で格納した、営業時間の配列。場所が営業していない日は含まれません。
weekdayDescriptions
タイプ:  Array<string>
1 週間の各曜日の書式設定された営業時間を表す 7 つの文字列の配列。プレイス サービスは、現在の言語に合わせて営業時間を適切にフォーマットしてローカライズします。この配列の要素の順番は、言語によって異なります。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 の範囲の数値)。これは場所のタイムゾーンで報告されます。

ParkingOptions クラス

google.maps.places.ParkingOptions クラス

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

hasFreeGarageParking
タイプ:  boolean optional
無料の屋内駐車場があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasFreeParkingLot
タイプ:  boolean optional
無料駐車場があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasFreeStreetParking
タイプ:  boolean optional
無料の路上駐車スペースがあるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasPaidGarageParking
タイプ:  boolean optional
有料の屋内駐車場があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasPaidParkingLot
タイプ:  boolean optional
有料駐車場があるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasPaidStreetParking
タイプ:  boolean optional
有料の路上駐車スペースがあるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
hasValetParking
タイプ:  boolean optional
バレーパーキングが利用できるかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。

PaymentOptions クラス

google.maps.places.PaymentOptions クラス

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

acceptsCashOnly
タイプ:  boolean optional
現金での支払いのみを受け付けているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
acceptsCreditCards
タイプ:  boolean optional
クレジット カードによる支払いが可能かどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
acceptsDebitCards
タイプ:  boolean optional
デビットカードによる支払いを受け付けているかどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。
acceptsNFC
タイプ:  boolean optional
NFC による支払いが可能かどうか。値が既知の場合は「true」または「false」を返します。値が不明な場合は「null」を返します。

Photo クラス

google.maps.places.Photo クラス

場所の写真に関する情報。

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

authorAttributions
タイプ:  Array<AuthorAttribution>
この写真に表示される帰属表示。
flagContentURI
タイプ:  string optional
ユーザーが写真の問題を報告できるリンク。
googleMapsURI
タイプ:  string optional
Google マップに写真を表示するためのリンク。
heightPx
タイプ:  number
写真の高さ(ピクセル単位)。
widthPx
タイプ:  number
写真の幅(ピクセル単位)。
getURI
getURI([options])
パラメータ: 
戻り値:  string
指定されたオプションに対応する画像 URL を返します。

PlusCode クラス

google.maps.places.PlusCode クラス

場所の Plus Code。詳しくは、https://plus.codes/ をご覧ください。

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

compoundCode
タイプ:  string optional
1/8000 度 × 1/8000 度のエリアを表す Plus Codes。最初の 4 文字(市外局番)が省略され、代わりに地域の説明が使用されます。(例: 「9G8F+5W Zurich, Switzerland」)。
globalCode
タイプ:  string optional
8,000 分の 1 度 x 8,000 分の 1 度のエリアを表す Plus Code。(例: 「8FVC9G8F+5W」)。

PostalAddress クラス

google.maps.places.PostalAddress クラス

郵便物の宛先(郵便サービスがアイテムを配達する宛先など)を表します。注: PostalAddress は、JavaScript API でウェブサービスから返されたデータを表すオブジェクトをインスタンス化するために使用されます。

このクラスは PostalAddressLiteral を実装します。

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

addressLines
タイプ:  Array<string>
住所の下位部分を記述する非構造化の住所行。
administrativeArea
タイプ:  string optional
国または地域の住所で使われる最上位の行政区画。
languageCode
タイプ:  string optional
この住所の内容の BCP-47 言語コード。例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。
locality
タイプ:  string optional
一般的に住所の市町村部分を指します。
organization
タイプ:  string optional
その住所にある組織の名前。
postalCode
タイプ:  string optional
住所の郵便番号。
recipients
タイプ:  Array<string>
その住所で受け取る人。
regionCode
タイプ:  string
住所の国 / 地域に対応する CLDR 地域コード。例: スイスの場合は「CH」。詳細については、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。
sortingCode
タイプ:  string optional
住所のソートコード。
sublocality
タイプ:  string optional
住所の市町村部分の下位の区画(近隣地域、区、地区など)。

PostalAddressLiteral インターフェース

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

PostalAddress をハイドレートするためのデータ。

regionCode
タイプ:  string
PostalAddress.regionCode をご覧ください。
addressLines optional
タイプ:  Iterable<string> optional
PostalAddress.addressLines をご覧ください。
administrativeArea optional
タイプ:  string optional
PostalAddress.administrativeArea をご覧ください。
languageCode optional
タイプ:  string optional
PostalAddress.languageCode をご覧ください。
locality optional
タイプ:  string optional
PostalAddress.locality をご覧ください。
organization optional
タイプ:  string optional
PostalAddress.organization をご覧ください。
postalCode optional
タイプ:  string optional
PostalAddress.postalCode をご覧ください。
recipients optional
タイプ:  Iterable<string> optional
PostalAddress.recipients をご覧ください。
sortingCode optional
タイプ:  string optional
PostalAddress.sortingCode をご覧ください。
sublocality optional
タイプ:  string optional
PostalAddress.sublocality をご覧ください。

PriceLevel 定数

google.maps.places.PriceLevel 定数

場所の価格レベル。

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

PriceRange クラス

google.maps.places.PriceRange クラス

場所に関連付けられた価格帯。endPrice は未設定にできます。これは、上限のない範囲(「$100 超」など)を示します。

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

endPrice
タイプ:  Money optional
価格帯の上限(指定した価格も含む)。価格はこの金額より低く設定してください。
startPrice
タイプ:  Money
価格帯の下限(この値を含む)。価格はこの金額以上にする必要があります。

Review クラス

google.maps.places.Review クラス

場所のクチコミに関する情報。

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

authorAttribution
タイプ:  AuthorAttribution optional
レビュー担当者。
flagContentURI
タイプ:  string optional
ユーザーがレビューの問題を報告できるリンク。
googleMapsURI
タイプ:  string optional
Google マップでクチコミを表示するためのリンク。
originalText
タイプ:  string optional
元の言語のレビュー テキスト。
originalTextLanguageCode
タイプ:  string optional
クチコミの元の言語を示す IETF 言語コード。
publishTime
タイプ:  Date optional
rating
タイプ:  number optional
このレビューの評価。1.0 ~ 5.0(指定した値を含む)の数値。
relativePublishTimeDescription
タイプ:  string optional
フォーマットされた最近の時刻の文字列。言語と国に適した形式で、現在の時刻を基準としたレビュー時刻を表します。(例: `"a month ago"')。
text
タイプ:  string optional
ローカライズされたレビューのテキスト。
textLanguageCode
タイプ:  string optional
クチコミのローカライズされた言語を示す IETF 言語コード。
visitDateMonth
タイプ:  number optional
クチコミの投稿者がその場所を訪れた日付の月。このフィールドは 0 から始まります。0 は 1 月、11 は 12 月です。
visitDateYear
タイプ:  number optional
クチコミの投稿者がその場所を訪れた日付の年。

ReviewSummary クラス

google.maps.places.ReviewSummary クラス

場所のユーザー レビューの AI 生成の要約。

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

disclosureText
タイプ:  string optional
この概要に関連する開示のテキスト。
disclosureTextLanguageCode
タイプ:  string optional
開示テキストの言語コード。
flagContentURI
タイプ:  string optional
概要に関する問題を報告するための URI。
reviewsURI
タイプ:  string optional
Google マップでこの場所のクチコミを表示する URI。
text
タイプ:  string optional
ユーザー レビューの概要。
textLanguageCode
タイプ:  string optional
ユーザー レビューの要約の言語コード。

SearchByTextRequest インターフェース

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

Place.searchByText のリクエスト インターフェース。

fields
タイプ:  Array<string>
レスポンスに含めるフィールド。このフィールドは課金対象となります。['*'] が渡された場合は、使用可能なフィールドがすべて返され、課金されます(本番環境のデプロイでは推奨されません)。Place クラスの任意のプロパティをフィールドとしてリクエストできます。
evSearchOptions optional
タイプ:  EVSearchOptions optional
Place Search リクエストに指定できる EV 関連のオプション。
includedType optional
タイプ:  string optional
リクエストされた場所タイプ。サポートされているタイプの完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。サポートされている included タイプは 1 つのみです。SearchByTextRequest.useStrictTypeFiltering を参照
isOpenNow optional
タイプ:  boolean optional
デフォルト: false
現在営業中の場所に検索を制限するために使用します。
language optional
タイプ:  string optional
Place Details は、可能であれば優先言語で表示されます。デフォルトでは、ブラウザの言語設定が使用されます。サポートされている言語の最新リスト: https://developers.google.com/maps/faq#languagesupport
locationBias optional
検索するリージョン。この位置はバイアスとして機能します。つまり、指定された位置周辺の結果が返される可能性があります。locationRestriction と一緒に設定することはできません。
locationRestriction optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
検索するリージョン。この位置情報は制限として機能します。つまり、指定された位置情報以外の結果は返されません。locationBias と一緒に設定することはできません。
maxResultCount optional
タイプ:  number optional
ページあたりの結果数の上限です。1 ~ 20 の範囲で指定してください。
minRating optional
タイプ:  number optional
ユーザーの平均評価がこの上限を厳密に下回る結果を除外します。有効な値は、0 ~ 5(両端の値を含む)の範囲で 0.5 刻みの浮動小数点数([0, 0.5, 1.0, ... , 5.0] など)にする必要があります。入力された評価は、最も近い 0.5 の値に切り上げられます。たとえば、評価が 0.6 の場合、評価が 1.0 未満の結果はすべて除外されます。
priceLevels optional
タイプ:  Array<PriceLevel> optional
特定の価格レベルとしてマークされている場所に検索を制限するために使用されます。価格レベルは自由に組み合わせて選択できます。デフォルトはすべての価格レベルです。
query optional
タイプ:  string optional
BetarankBy optional
タイプ:  SearchByTextRankPreference optional
rankPreference optional
タイプ:  SearchByTextRankPreference optional
デフォルト: SearchByTextRankPreference.RELEVANCE
レスポンスで結果をランク付けする方法。
region optional
タイプ:  string optional
リクエストの送信元となるロケーションの Unicode 国 / リージョン コード(CLDR)。このパラメータは、地域固有の場所名など、Place Details を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。3 桁の地域コードは現在サポートされていません。
textQuery optional
タイプ:  string optional
SearchByTextRequest.query を使用しない場合は必須です。テキスト検索のテキストクエリ。
useStrictTypeFiltering optional
タイプ:  boolean optional
デフォルト: false
SearchByTextRequest.includedType の厳密なタイプ フィルタリングを設定するために使用されます。true に設定すると、同じタイプの検索結果のみが返されます。

SearchByTextRankPreference 定数

google.maps.places.SearchByTextRankPreference 定数

SearchByTextRequest の RankPreference 列挙型。

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

DISTANCE 結果を距離順にランク付けします。
RELEVANCE 関連性に基づいて結果をランク付けします。

SearchNearbyRequest インターフェース

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

Place.searchNearby のリクエスト インターフェース。リクエストの詳細については、Places API リファレンスをご覧ください。

fields
タイプ:  Array<string>
レスポンスに含めるフィールド。このフィールドは課金対象となります。['*'] が渡された場合は、使用可能なフィールドがすべて返され、課金されます(本番環境のデプロイでは推奨されません)。Place クラスの任意のプロパティをフィールドとしてリクエストできます。
locationRestriction
タイプ:  Circle|CircleLiteral
検索するリージョン。中心と半径を持つ円として指定します。指定された場所の外の結果は返されません。
excludedPrimaryTypes optional
タイプ:  Array<string> optional
除外する主な場所タイプ。サポートされているタイプの全リストをご覧ください。1 つの場所に設定できるメインタイプは 1 つのみです。最大 50 個のタイプを指定できます。included リストと excluded リストの両方に同じタイプを指定すると、INVALID_ARGUMENT エラーが返されます。
excludedTypes optional
タイプ:  Array<string> optional
除外する場所タイプ。サポートされているタイプの全リストをご覧ください。1 つの場所に複数のプレイスタイプを設定できます。最大 50 個のタイプを指定できます。included リストと excluded リストの両方に同じタイプを指定すると、INVALID_ARGUMENT エラーが返されます。
includedPrimaryTypes optional
タイプ:  Array<string> optional
含まれる主な場所タイプ。サポートされているタイプの全リストをご覧ください。1 つの場所に設定できるメインタイプは 1 つのみです。最大 50 個のタイプを指定できます。included リストと excluded リストの両方に同じタイプを指定すると、INVALID_ARGUMENT エラーが返されます。
includedTypes optional
タイプ:  Array<string> optional
含める場所タイプ。サポートされているタイプの全リストをご覧ください。1 つの場所に複数のプレイスタイプを設定できます。最大 50 個のタイプを指定できます。included リストと excluded リストの両方に同じタイプを指定すると、INVALID_ARGUMENT エラーが返されます。
language optional
タイプ:  string optional
Place Details は、可能であれば優先言語で表示されます。デフォルトでは、ブラウザの言語設定が使用されます。サポートされている言語の最新リスト: https://developers.google.com/maps/faq#languagesupport
maxResultCount optional
タイプ:  number optional
ページあたりの結果数の上限です。有効な値とデフォルト値については、Places API リファレンスをご覧ください。
rankPreference optional
タイプ:  SearchNearbyRankPreference optional
デフォルト: SearchNearbyRankPreference.POPULARITY
レスポンスで結果をランク付けする方法。
region optional
タイプ:  string optional
リクエストの送信元となるロケーションの Unicode 国 / リージョン コード(CLDR)。このパラメータは、地域固有の場所名など、Place Details を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。3 桁の地域コードは現在サポートされていません。

SearchNearbyRankPreference 定数

google.maps.places.SearchNearbyRankPreference 定数

SearchNearbyRequest の RankPreference 列挙型。

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

DISTANCE 結果を距離順にランク付けします。
POPULARITY 人気度で結果をランク付けします。