ガイドAPIリファレンス変更履歴
ガイド
  1. HERE Geocoding and Search API v7開発者ガイド
  2. リクエストパラメーターを設定する
  3. レスポンスの強化

地図参照を使用したレスポンスの強化

リクエストパラメーターshowMapReferencesを使用すると、地図参照を使用して特定のレスポンス項目を強化し、他のサービスまたはデータアプリケーションと接続できるようになります。

現在 showMapReferences でサポートされている値は次の表のとおりです。

showMapReferences 値エンドポイント成熟度および特権説明
segments/autosuggest、/geocode、/revgeocode、/multi-revgeocode、/lookupGAresultType=houseNumber、resultType=street、resultType=place の結果項目の場合、結果のアクセス位置からセグメント参照を返します。
例外：日本では、resultType=street の場合のみセグメント参照を返します。
注：
以前のパラメーター show=hmcReference は廃止され、同じ役割を果たす showMapReferences=segments に置き換わります。
結果に複数のアクセス位置が含まれる場合、複数のセグメント参照が返されることがあります。
詳細については、API リファレンスを参照してください。
links/geocode、/revgeocode、/multi-revgeocode、/lookupGAresultType=houseNumber、resultType=street、resultType=place の結果項目の場合、結果のアクセス位置からリンク参照を返します。
例外：日本では、リンク参照は返されません。
注：結果に複数のアクセス位置が含まれる場合、複数のリンク参照が返されることがあります。
詳細については、API リファレンスを参照してください。
pointAddress/autosuggest、/geocode、/revgeocode、/multi-revgeocode、/lookupGAresultType=houseNumber と houseNumberType=PA の結果項目の場合、HERE Map Content の仕様に沿ってフォーマットされたポイント住所識別子が含まれます。
microPointAddress/geocode、/revgeocode、/multi-revgeocode、/lookupGA、RESTRICTEDresultType=houseNumberとhouseNumberType=MPAの結果項目の場合、HERE Map Contentの仕様に沿ってフォーマットされたマイクロポイント住所識別子が含まれます。
adminIds/autosuggest、/geocode、/revgeocode、/multi-revgeocode、/lookupGAHERE Map Content の仕様に沿ってフォーマットされた、結果項目の address ブロックの行政区分識別子を返します。
cmVersion/geocode、/revgeocode、/multi-revgeocode、/lookupGA結果項目が位置する地域のコア マップ バージョン番号を返します。マップ バージョンの詳細 (DVN) には、マップ スキーマのベースラインと、週次更新または四半期更新の識別子が含まれます。フォーマット：YYQ<週次/quarter>、例：24121 (マップ スキーマ：Q1/2024、週次更新 21)
例外：この機能は日本の地図情報ではサポートされていません。

showMapReferences=segments,links,pointAddress,adminIds,cmVersionを使用した/revgeocodeエンドポイントレスポンスの例：

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=52.518333,13.408333
    &types=address
    &lang=en-US
    &showMapReferences=segments,links,pointAddress,adminIds,cmVersion
    &apiKey={YOUR_API_KEY}

{
          "title": "Rathausstraße 15, 10178 Berlin, Germany",
          "id": "here:af:streetsection:2pGteqRk7Ros60IJL5KyEA:CgcIBCCk6s5QEAEaAjE1",
          "resultType": "houseNumber",
          "houseNumberType": "PA",
          "address": {
              "label": "Rathausstraße 15, 10178 Berlin, Germany",
              "countryCode": "DEU",
              "countryName": "Germany",
              "stateCode": "BE",
              "state": "Berlin",
              "countyCode": "B",
              "county": "Berlin",
              "city": "Berlin",
              "district": "Mitte",
              "street": "Rathausstraße",
              "postalCode": "10178",
              "houseNumber": "15"
          },
          "position": {"lat": 52.51856, "lng": 13.40821},
          "access": [{"lat": 52.51874, "lng": 13.40796}],
          "distance": 27,
          "mapView": {...},
          "mapReferences": {
              "links": [
                  {
                      "cmId": "733328455",
                      "side": "right"
                  }
              ],
              "pointAddress": {
                  "hmcId": "here:cm:pointaddress:169063716"
              },
              "segments": [
                  {
                      "ref": "here:cm:segment:783444988#0.481734",
                      "side": "left"
                  }
              ],
              "country": {
                  "hmcId": "here:cm:namedplace:20147700"
              },
              "state": {
                  "hmcId": "here:cm:namedplace:20187401"
              },
              "county": {
                  "hmcId": "here:cm:namedplace:20187402"
              },
              "city": {
                  "hmcId": "here:cm:namedplace:20187403"
              },
              "district": {
                  "hmcId": "here:cm:namedplace:20187417"
              },
              "cmVersion": {
                  "region": "WEU",
                  "dvn": "24121"
              }
          }
}
注
  • linkId は廃止され削除されたため、cmId に置き換えられます。
  • sideOfLink は廃止され削除されたため、side に置き換えられます。
  • リンク方向がセグメント方向と一致している場合、同じエンティティの link.side と segment.side は同じになります。ただし、リンク方向がセグメント方向と一致していない場合、これらは異なる場合があります。
    • フォワード リンク方向は、参照ノードから非参照ノードへの方向と定義されます。参照ノードの緯度が非参照ノードよりも小さい場合、最南端から最北端の方向になります。両方の終了ノードの緯度が同じで、経度が異なる場合、最西端ノードから最東端ノードの方向になります。
    • フォワード セグメント方向は、セグメント開始ノードからセグメント終了ノードへの方向と定義されます。
  • 以前のパラメーターshow=hmcReferenceは廃止され、同じ役割を果たすshowMapReferences=segmentsに置き換わります。

4 日前の更新