Place (beta)

Place クラス

google.maps.places.Place クラス

注意: v=beta チャネルでのみご利用いただけます。

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

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

静的メソッド
findPlaceFromPhoneNumber	注意: v=beta チャネルでのみご利用いただけます。 findPlaceFromPhoneNumber(request) パラメータ:  request:  FindPlaceFromPhoneNumberRequest 電話番号とリクエストされたフィールドを含むリクエスト。 戻り値:  Promise<{places:Array<Place>}> 指定された電話番号に基づいて場所を検索します。まれなケースですが、複数の場所で 1 つの電話番号を共有する場合があるため、配列を返します。
findPlaceFromQuery	注意: v=beta チャネルでのみご利用いただけます。 findPlaceFromQuery(request) パラメータ:  request:  FindPlaceFromQueryRequest テキストクエリとリクエストされたフィールドを含むリクエスト。 戻り値:  Promise<{places:Array<Place>}> 指定されたテキストクエリで場所を検索します。クエリがややあいまいで、複数の場所が返される場合は、配列を返します。この方法は、複数の結果が想定される検索を対象としたものではありません。
searchByText	注意: v=beta チャネルでのみご利用いただけます。 searchByText(request) パラメータ:  request:  SearchByTextRequest 戻り値:  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	注意: v=beta チャネルでのみご利用いただけます。 タイプ:  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 場所の価格レベル。このプロパティは次のいずれかの値を返します。 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 企業のホームページなど、このプレイスの公式ウェブサイトです。

Methods
fetchFields	注意: v=beta チャネルでのみご利用いただけます。 fetchFields(options) パラメータ:  options:  FetchFieldsRequest 戻り値:  Promise<{place:Place}>
getNextOpeningTime	注意: v=beta チャネルでのみご利用いただけます。 getNextOpeningTime([date]) パラメータ:  date:  Date optional 戻り値:  Promise<Date optional> 次の OpeningHoursTime を表す Date を計算します。結果を計算するためのデータが不足している場合、またはこの場所が営業していない場合は、未定義の値を返します。
isOpen	注意: v=beta チャネルでのみご利用いただけます。 isOpen([date]) パラメータ:  date:  Date optional デフォルトは現在です。 戻り値:  Promise<boolean optional> その場所が特定の日時に営業しているかどうかを確認します。営業時間が未登録の場合など、場所の既知のデータだけでは算出できない場合、undefined で解決します。
toJSON	toJSON() パラメータ: なし 戻り値:  Object リクエストされたすべてのプレイス プロパティを含む JSON オブジェクト。

PlaceOptions インターフェース

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

注意: v=beta チャネルでのみご利用いただけます。

プレイス構築のオプション。

プロパティ
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」（厳密には「United Kingdom of Great Britain and Northern Ireland」（グレート ブリテンおよび北アイルランド連合王国）の法人）です。

AddressComponent クラス

google.maps.places.AddressComponent クラス

注意: v=beta チャネルでのみご利用いただけます。

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

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

Attribution クラス

google.maps.places.Attribution クラス

注意: v=beta チャネルでのみご利用いただけます。

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

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

FetchFieldsRequest インターフェース

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

注意: v=beta チャネルでのみご利用いただけます。

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

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

OpeningHours クラス

google.maps.places.OpeningHours クラス

注意: v=beta チャネルでのみご利用いただけます。

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

プロパティ
periods	タイプ:  Array<OpeningHoursPeriod> 営業時間帯。日曜日から始まる各曜日を時系列で表示します。その場所が営業していない日は含まれません。
weekdayDescriptions	タイプ:  Array<string> 各曜日の書式設定された営業時間を表す 7 つの文字列の配列。プレイス サービスでは、営業時間が現在の言語に合わせて適切にフォーマットおよびローカライズされます。この配列の要素の順番は言語によって異なります。1 週間が月曜日から始まる言語もあれば、日曜日から始まる言語もあります。

OpeningHoursPeriod クラス

google.maps.places.OpeningHoursPeriod クラス

注意: v=beta チャネルでのみご利用いただけます。

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

プロパティ
close	タイプ:  OpeningHoursPoint optional 場所の閉店時間です。
open	タイプ:  OpeningHoursPoint 場所の営業時間です。

OpeningHoursPoint クラス

google.maps.places.OpeningHoursPoint クラス

注意: v=beta チャネルでのみご利用いただけます。

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

注意: v=beta チャネルでのみご利用いただけます。

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

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

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

AuthorAttribution クラス

google.maps.places.AuthorAttribution クラス

注意: v=beta チャネルでのみご利用いただけます。

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

注意: v=beta チャネルでのみご利用いただけます。

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

プロパティ
compoundCode	タイプ:  string optional 次数 1/8000 x 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 チャネルでのみご利用いただけます。

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 言語コード。このコードには、メイン言語のタグのみが含まれており、国または地域を示す 2 つ目のタグはありません。たとえば、英語のレビューはすべて、「en-AU」や「en-UK」ではなく 'en' としてタグ付けされます。

PriceLevel 定数

google.maps.places.PriceLevel 定数

注意: v=beta チャネルでのみご利用いただけます。

プレイス オブジェクトの料金レベルの列挙型。

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

定数
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

SearchByTextRequest インターフェース

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

注意: v=beta チャネルでのみご利用いただけます。

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

プロパティ
fields	タイプ:  Array<string> レスポンスに含めるフィールド（課金対象）。['ALL'] が渡されると、使用可能なすべてのフィールドが返されて課金されます（これは本番環境のデプロイには推奨されません）。フィールドの一覧については、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	タイプ:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|CircleLiteral|Circle optional 検索する地域。この地域はバイアスとして機能し、特定の場所の周辺の結果が返されることがあります。locationRestriction と同時に設定することはできません。
locationRestriction optional	タイプ:  LatLngBounds|LatLngBoundsLiteral optional 検索する地域。この地域は制限として機能し、指定された地域外の結果は返されません。locationBias とともに設定することはできません。
maxResultCount optional	タイプ:  number optional 返される結果の最大数。1 ～ 20 の範囲で指定してください。
minRating optional	タイプ:  number optional ユーザーの平均評価がこの上限を下回っている結果を除外します。有効な値は、0.5 間隔（0.5 以下、1.0 ～ 5.0 など）で 0 ～ 5（両端を含む）の浮動小数点数にする必要があります。入力定格は 0.5（上限）単位で切り上げられます。たとえば、評価が 0.6 の場合、評価が 1.0 未満のすべての検索結果が除外されます。
priceLevels optional	タイプ:  Array<PriceLevel> optional 検索対象を特定の価格帯としてマークされた場所に制限するために使用します。価格レベルの任意の組み合わせを選択できます。デフォルトはすべての料金レベルです。
query optional	非推奨: 代わりに textQuery を使用してください。 タイプ:  string optional
rankBy optional	タイプ:  SearchByTextRankBy optional デフォルト: SearchByTextRankBy.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 に設定すると、同じタイプの結果のみが返されます。

SearchByTextRankBy 定数

google.maps.places.SearchByTextRankBy 定数

注意: v=beta チャネルでのみご利用いただけます。

SearchByTextRequest の RankBy 列挙型。

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

定数
DISTANCE	距離を基準に結果をランク付けします。
RELEVANCE	関連性によって結果をランク付けします。