境界線用データドリブン スタイル設定で Places API 群とジオコーディングを利用する

プラットフォームを選択: iOS JavaScript

Places SDK for iOS と Geocoding API と Maps SDK for iOS を使用すると、地域を検索したり、場所に関する詳細情報を取得したりできます。Places SDK for iOS と Geocoding API は、プレイス ID を取得できる便利で安定性の高いツールです。すでにプレイス ID を使用している場合、それらの ID を境界線用データドリブン スタイル設定で再利用できます。

Places SDK for iOS アプリに Places API と Geocoding API を追加するには、以下の方法があります。

  • Places SDK for iOS は、HTTP リクエストを使用して場所に関する情報を返します。
  • CLGeocoder クラスは、ユーザー入力から動的にジオコーディングとリバース ジオコーディングを実行できます。
  • Geocoding API を使用すると、既知の住所を静的にジオコーディングできます。

Places API を使用する

  • Places API Text Search は、「渋谷 ピザショップ」「表参道 靴店」「123 番地」といった文字列に対して、場所のセットについての情報を返します。テキスト文字列と、設定されている位置情報バイアスに一致する場所のリストがレスポンスとして返されます。

  • Places Autocomplete サービスを利用すると、ユーザーが地域を簡単に検索できるようになります。定義されたリージョン内で結果を表示するには、GMSAutocompleteFilter に locationRestriction を設定します。

地域の Place Details を取得する

  • 地域の Place Details データも有効です。たとえば次のようなことができます

    • 地名に基づいて境界線のプレイス ID を検索する。
    • 境界線にズームするビューポートを取得する。
    • 境界線の対象物タイプ（地域区分など）を取得します。
    • フォーマット済み住所を取得します。これは、米国地域の「地名、州、国」に解決されます（例: 「カークランド、ワシントン、アメリカ」）。
    • 写真など、その他の便利なデータを取得する。

Geocoding API を使用する

  • Geocoding API を使用すると、住所、緯度と経度の座標、プレイス ID を地理座標に変換できます。また、その逆も可能です。次のような使用方法は、境界線用データドリブン スタイル設定と組み合わせると効果的です。

    • ジオコーディングを使用して地域のビューポートを取得する。
    • ジオコーディングの呼び出しにコンポーネント フィルタリングを適用して、行政区域 1 ～ 4、地域区分、郵便番号のプレイス ID を取得します。
    • リバース ジオコーディングを使用すると、緯度と経度の座標でプレイス ID を取得できます。また、特定の場所のすべてのコンポーネントのプレイス ID を返すこともできます。

    次の例では、URL エスケープされた住所を使用して、Geocoding API にリクエストを送信します。

    https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

    リバース ジオコーディングを使ってプレイス ID を確認できます。次の例のジオコーディング サービス関数は、指定された緯度と経度の座標にあるすべての住所コンポーネントのプレイス ID を返します。

    https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY

    コンポーネント フィルタリングでリバース ジオコーディングを使用して、指定された場所で以下の 1 つ以上のタイプの住所コンポーネントを取得します。

    • administrativeArea
    • country
    • locality
    • postalCode
    • schoolDistrict

    次の例では、ジオコーディング サービスを使用し、リバース ジオコーディングでコンポーネントの制限を追加して、locality タイプの指定された場所にあるすべての住所コンポーネントを取得します。

    https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY