Place

Place クラス

google.maps.places.Place クラス

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

Place
Place(options)
パラメータ: 
searchByText
searchByText(request)
パラメータ: 
戻り値:  Promise<{places:Array<Place>}>
テキストクエリによる場所の検索。
accessibilityOptions
タイプ:  AccessibilityOptions optional
この場所のユーザー補助オプション。ユーザー補助オプション データがサーバーから呼び出されていない場合は undefined
addressComponents
タイプ:  Array<AddressComponent> optional
このプレイスの位置の住所コンポーネントのコレクション。既知の住所データがない場合は空のオブジェクト。undefined: サーバーから住所データが呼び出されていない場合。
adrFormatAddress
タイプ:  string optional
プレイスの住所を adr microformat で表したもの。
attributions
タイプ:  Array<Attribution> optional
このプレイスの結果に対して表示される属性テキスト。
businessStatus
タイプ:  BusinessStatus optional
ビジネスの営業状況です。既知のステータスがない場合は null。ステータス データがサーバーから読み込まれていない場合は undefined
displayName
タイプ:  string optional
ビジネスの表示名。null(名前がない場合)。名前データがサーバーから読み込まれていない場合は undefined
editorialSummary
タイプ:  string optional
この場所の編集による概要です。編集者による概要がない場合は null。このフィールドがまだリクエストされていない場合は undefined
editorialSummaryLanguageCode
タイプ:  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」を返します。このフィールドがまだリクエストされていない場合は、「未定義」を返します。
iconBackgroundColor
タイプ:  string optional
場所のカテゴリのデフォルトの 16 進数色コードです。
id
タイプ:  string
一意のプレイス ID。
internationalPhoneNumber
タイプ:  string optional
プレイスの電話番号(国際電話形式)。国際形式では、「+」記号と国コードが先頭に付きます。
isReservable
タイプ:  boolean optional
場所が予約可能かどうか。値がわかっている場合は「true」または「false」を返します。値が不明な場合は「null」を返します。このフィールドがまだリクエストされていない場合は、「未定義」を返します。
location
タイプ:  LatLng optional
プレイスの位置。
nationalPhoneNumber
タイプ:  string optional
電話番号の地域慣例に従ってフォーマットされたプレイスの電話番号。
photos
タイプ:  Array<Photo> optional
この場所の写真。コレクションには、最大 10 個の Photo オブジェクトが含まれます。
plusCode
タイプ:  PlusCode optional
priceLevel
タイプ:  PriceLevel optional
プレイスの料金レベル。このプロパティは次のいずれかの値を返します。
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
タイプ:  number optional
この場所のユーザー レビューに基づく評価(1.0 ~ 5.0)。
regularOpeningHours
タイプ:  OpeningHours optional
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_minutes660 になります。UTC より後のタイムゾーンの場合、オフセットは負になります。たとえば、カーボベルデの場合、utc_offset_minutes-60 です。
viewport
タイプ:  LatLngBounds optional
このプレイスを地図に表示する場合に優先されるビューポート。
websiteURI
タイプ:  string optional
企業のホームページなど、このプレイスの公式ウェブサイト。
openingHours
タイプ:  OpeningHours optional
fetchFields
fetchFields(options)
パラメータ: 
戻り値:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
パラメータ: 
  • dateDate optional
戻り値:  Promise<Date optional>
次の OpeningHoursTime を表す日付を計算します。結果を計算するためのデータが不十分な場合、またはこの場所が営業していない場合は、 未定義 を返します。
BetaisOpen
isOpen([date])
パラメータ: 
  • dateDate 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」(厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティです)です。

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

FetchFieldsRequest インターフェース

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

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

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

OpeningHours クラス

google.maps.places.OpeningHours クラス

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

periods
日曜日から始まる各曜日の営業時間帯(時系列)。場所が営業していない日は含まれません。
weekdayDescriptions
タイプ:  Array<string>
各曜日の書式設定された営業時間を表す 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])。この情報は場所のタイムゾーンで報告されます。

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/8,000 x 1/8,000 の次数の領域を持つ plus code。最初の 4 文字(市外局番)が省略され、地域記述に置き換えられます。例: 「9G8F+5W Zurich, Switzerland」
globalCode
タイプ:  string optional
次数を 1/8,000 × 1/8,000 の領域で表した 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 定数

プレイス オブジェクトの価格単位の列挙型。

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

SearchByTextRequest インターフェース

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

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

fields
タイプ:  Array<string>
レスポンスに含めるフィールド(課金の対象)。['*'] が渡されると、使用可能なすべてのフィールドが返されて課金されます(これは本番環境のデプロイでは推奨されません)。フィールドの一覧については、PlaceResult をご覧ください。ネストされたフィールドはドットパスで指定できます(例: "geometry.location")。
includedType optional
タイプ:  string optional
リクエストされた場所のタイプ。サポートされているタイプの一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。含まれるタイプは 1 つだけです。SearchByTextRequest.useStrictTypeFiltering をご覧ください
isOpenNow optional
タイプ:  boolean optional
デフォルト: false
現在営業中の場所のみに検索対象を限定するために使用します。
language optional
タイプ:  string optional
場所の詳細が使用言語で表示されます(選択可能な場合)。ブラウザの言語設定がデフォルトで使用されます。現在サポートされている言語については、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.DISTANCE
回答での結果がどのようにランク付けされるか。
region optional
タイプ:  string optional
リクエストの送信元であるロケーションの Unicode 国/地域コード(CLDR)。このパラメータは、地域ごとの場所の名前(利用可能な場合)など、場所の詳細を表示するために使用されます。パラメータは、適用される法律に基づいて結果に影響を与える可能性があります。詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。現在、3 桁の地域コードはサポートされていません。
textQuery optional
タイプ:  string optional
必須。テキスト検索用のテキストクエリ。
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 関連性によって結果をランク付けします。