このドキュメントでは、Nearby Search(新版)API の使用方法を解説します。 シンプルで費用対効果の高い
地域固有の発見をしています。
地域の情報検索エクスペリエンスで、ある場所の周辺にある重要な注目スポットをユーザーに提示 ホテルや不動産を検索する際に指定する ことができます多くの場合、 インタラクティブな地図に加え、スポット選択ツールと 表示されます。表示される Google Maps Platform には インタラクティブなエクスペリエンスを強化するためのプロダクトと機能。
ユースケース
では、ローカル検索の統合のどの要素がユーザーに貢献しているかを理解しましょう。 value:
検索 - 特定の場所の周辺地域の概要をユーザーに表示します。 さまざまなタイプの関連する場所を表示して、ユーザーの位置情報を把握できます。
インタラクティビティ - ユーザーが場所を選択し、データを動的に更新できるようにする
移動します
可視化 - 場所に関するクチコミや写真を提供
歩行時間と距離を表示することで ユーザーが合っているかどうかをすばやく把握できます 提供します。
リファレンス アーキテクチャ
ローカル検索
地域の情報を検索するための方法はたくさんあります。次の 統合は、Google Cloud を活用したユーザー エクスペリエンスのカスタム サンプル 既知の Google Maps Platform API と 魅力的な新機能の一部を紹介しますもし ローカル検索に対するテンプレート化されたアプローチが必要な場合は、ウェブ コンポーネントをご覧ください。
サンプル アプリケーション
サンプルのチュートリアル
サンプル アプリケーションの下の表を手順ごとに示します。 および Google マップを使用した技術的な実装の説明 Platform API。
1. AutocompleteSearch location を使用する場所検索
- Maps JavaScript API を読み込みます。
- Places Autocomplete をクエリしたり、地図上の場所を選択したりできます。
2. Nearby Search(新)API を使用して地元のスポットを表示する
- 人気度ランキング(より関連性の高い検索結果)または距離ランキング。
includedTypes
、excludedTypes
、ホテルの場合は 「宿泊施設」タイプで、適切なタイプ(レストラン、カフェ、公園、 Tourit_attraction」を追加します。includedPrimaryTypes
、excludedPrimaryTypes
をさらに活用 結果を制御できます。- 結果の数が不十分な場合や離れすぎないようにするための locationRestriction 場所、結果がゼロの場合は、事前に円 / 長方形のサイズを広げる 結果を表示します
リクエストされたデータ フィールドを使用してホテルを予約する際のクエリサンプル:
- 基本(
displayName
、types
、openingHours
、formattedAddress
) - 連絡先(
websiteUri
、nationalPhoneNumber
、internationalPhoneNumber
) - 優先(
reviews
、priceLevel
、userRatingCount
)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes": ["lodging","convenience_store"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
リクエストされたデータ フィールドを使用して不動産を検索するときのクエリサンプル:
- 基本(
displayName
、types
、openingHours
、formattedAddress
)
{ "includedTypes": ["school","transport","bus","convenience_store"], "excludedTypes": ["lodging"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
3. Dynamic Maps と Directions API を使用してインタラクティビティを追加する
- 検索してルートと歩数を最新にすることをルート検索 API。 * 次のセクションでは時間を使用します。
4. 操作時に場所の詳細情報を表示する
説明:
displayName
、types
、rating
、userRatingCount
、priceLevel
。時間: 前の Directions API クエリから取得。
レビュー:
reviews[i].author
、reviews[i].rating
、reviews[i].text
。画像: Nearby Search(新版)API の無制限プレビュー中は、 ユーザーはPlaces API を 詳細
place.id
で取得 photo_reference 一度に 1 つずつクエリを実行できます
クエリの数と関連する費用
- Maps JavaScript API: エクスペリエンスの読み込み時に 1 つの地図。
- Places Autocomplete API: 文字が入力されるたびに 1 つのクエリ( 予測入力 ウィジェット) カスタマイズできます。
- Nearby Search(新版) API: 20 か所の表示ごとに 1 つのクエリ。場所に応じて異なる請求 データ クエリレスポンスの一部です
- ルート API: ユーザーが選択したすべての場所に対して 1 回のクエリ
- Place Photo API: 1 クエリで、表示されるすべての写真に対してクエリを実行します。
まとめ
ローカル検索エクスペリエンスは、ユーザーに価値をもたらす優れた方法です。この デモ実装には多くの機能が含まれています 特別な機能を備えた Google Maps Platform でそのようなエクスペリエンスを創出する Nearby Search (新) API から 。
次のステップ
関連資料の候補:
- Maps JavaScript API での Web Components 活用
- Places Autocomplete の最適化
- その他の Places サービス
- 以下にフィードバックをお寄せください。
協力者
主要な著者:
Thomas Anglaret |Google マップ プラットフォーム ソリューション エンジニア