ジオ コーディングおよび Landmark ジオ コーディングリクエストを移行します

このセクションでは 、 HERE Geocoder API ジオ コーディング リクエストを GS7 ジオコード リクエストおよび GS7 ID による検索 リクエストに移行するために実行する必要があるアクションについて説明します。

HERE Geocoder API Landmark ジオ コーディング: サポートされていません。 ランドマーク検索にはを使用 /discoverします。 Landmark ジオ コーディングを使用して住所を検索する場合 /geocodeは、を使用します。

パラメータのタイプまたは仕様の詳細について は、『開発者ガイド』を参照してください。

基本 URL 、バージョン、リソース

GS7 /geocode エンドポイントを使用して、 freeform または修飾検索テキストクエリを GS7 に移行します。

パラメーター HERE Geocoder API GS7.
基本 URL https://geocoder.api.here.com https://geocode.search.hereapi.com
バージョン /6.2 /v1
リソース / エンドポイント /geocode /geocode
/search /geocode
書式指定子 .xml -
.json -

GS7 /discover エンドポイントを使用して、 Landmark クエリーを GS7 に移行します。

パラメーター HERE Geocoder API GS7.
基本 URL https://geocoder.api.here.com https://discover.search.hereapi.com
バージョン /6.2 /v1
リソース / エンドポイント /search /discover
書式指定子 .xml -
.json -

エンティティ /lookup を ID で検索するには、 GS7 エンドポイントを使用します。

パラメーター HERE Geocoder API GS7.
基本 URL https://geocoder.api.here.com https://lookup.search.hereapi.com
バージョン /6.2 /v1
リソース / エンドポイント /geocode /lookup
書式指定子 .xml -
.json -

HERE Geocoder API は、 XML および JSON 出力形式をサポートしています。 HERE Geocoding and Search v7 は、 JSON 出力形式のみをサポートしています。 したがって、書式指定子は必須ではなく、省略する必要があります。

クエリーパラメータ

HERE Geocoder API GS7. コメント
additionaldata=Country2 show=countryInfo
additionaldata=PreserveUnitDesignators show=parsing GS7 /geocode では、解析情報にセカンダリユニットデジグネータが含まれています。
city qq=city 例 : qq=city:Berlin
country in=countryCode GS7 は ISO 3166-1 のアルファ -3 国コードをサポートしており、大文字の使用を前提としたすべての文字が必要です。 例 : in=countryCode:DEU,AUT
countryfocus qq=country GS7 の認定国フィールド /geocode では、 ISO 3166-1 のアルファ -3 国コードのほかに、スペルで記述された国名がサポートされています。 このパラメータは、フィルタとは見なされませんが、構造化されたクエリーの一部として扱われます。 国名が一致する結果が高い順にランク付けされます。
county qq=county
district qq=district
housenumber qq=houseNumber GS7 /geocode では、建物名がクエリの一部として認識されます。 ただし、建物名のみに基づいて住所を検索することは許可されていません。 検索には、番地名と番地などのその他の詳細な住所情報、または IRL および SGP の場合は詳細な郵便番号が含まれている必要があります。
language lang 言語のリストはサポートされていません。
locationattributes.streetDetails ()sd show=streetInfo
maxresult limit GS7 limit パラメータは、結果の合計数を制限します。 GS7 には、複数の応答ページの概念はありません。
politicalview politicalview GS7 politicalview パラメータは、すべての大文字の単一 ISO 3166-1 アルファ -3 国コードを受け入れます。 現在サポートされている政治的見解の完全なリストについて は、サポートされている政治的見解を参照してください。 HERE Geocoding and Search が専用の政治的見解を持たない有効な 3 文字の国コードについては、デフォルトのビューに戻ります。
postalcode qq=postalCode
prox at GS7 at パラメーターは半径をサポートしていません。
responseattributes.parsedRequest ()pr show=parsing
searchText q
state qq=state
street qq=street HERE Geocoder API と同様 /geocode に、 GS7 では、 1 つの番地、住所、交差点の入力など、限定された道路フィールドがサポートされています。 番地の入力には番地が追加され、番地には番地が含まれています。住所には、スイート、アパート、および階数の情報が含まれている場合があります。 道路の交差点の入力には、定義済みの区切り文字のいずれかを使用して連結された 2 つ以上の道路名が含まれます ( グローバル : "&" 、 "@" 、および "AT"; さらに、スペイン語またはポルトガル語の道路名を使用するクエリの場合 : "esq" 、 "esquina" 、 "pol" 、 "con" 、 "y") 。 多くの場合、 Geocoder は、交差点の道路名をコンマまたはスペースで区切って検出することもできます。
locationattributes.timeZone ()tz show=tz

応答属性

HERE Geocoder API GS7. コメント
View.Result[].Relevance items[].scoring.queryScore HERE Geocoder API と同じセマンティックですが、計算ロジックを変更すると、値がわずかに異なる可能性があります。
View.Result[].Distance items[].distance
View.Result[].MatchLevel items[].resultType items[].addressBlockType次のいずれかで拡張 : 、 items[].localityTypeitems[].administrativeAreaType 詳細については 、「結果タイプ」を参照してください。 GS7 /geocode は Place の結果も返すことに注意してください。 配置結果は types 、フィルタ処理によって結果リストから除外されることがあります
View.Result[].MatchQuality items[].scoring.fieldScore HERE Geocoder API と同じセマンティックですが、計算ロジックを変更すると、値がわずかに異なる可能性があります。
View.Result[].MatchType items[].houseNumberType 詳細については 、「結果タイプ」を参照してください。
View.Result[].ParsedRequest items[].parsing リプレゼンテーションが変更されました。 詳細については 、『 API リファレンス』を参照してください。
View.Result[].Location.LocationId items[].id HERE Geocoder API の場所 ID と GS7 の ID の形式が異なり、互換性がありません。
View.Result[].Location.LocationType items.categories[] 場所の種類 : area および address は冗長として削除されます。 場所の種類 distanceMarker がサポートされていません。 その他の場所の種類は、場所のカテゴリ情報でカバーされます。 詳細について は、「場所のカテゴリ」システムを参照してください。
View.Result[].Location.Name items[].title GS7 フィールドタイトルには、結果アイテムのローカライズされた表示名が含まれています。 場所タイプの結果の場合、フィールドには場所の名前が表示されます。 住所タイプの結果の場合、このフィールドには住所のローカライズされた形式が表示されます。 結果のタイトルの形式は、 HERE Geocoder API で使用されているものとは異なる場合があります。特に、建物名には二重引用符は使用されません。
View.Result[].Location. DisplayPosition.Latitude items[].address.position.lat
View.Result[].Location. DisplayPosition.Longitude items[].address.position.lng
View.Result[].Location. NavigationPosition.Latitude items[].address.access.lat GS7 は、結果に accessposition そのポイントとは異なるポイントが含まれている場合にのみアクセス位置を返します。 HERE Geocoder API では、データが真のナビゲーション位置を提供しない場合、ナビゲーション位置は表示位置の単なる複製になります。
View.Result[].Location. NavigationPosition.Longitude items[].address.access.lng
View.Result[].Location.MapView items[].mapView データ形式が変更されました。 詳細については 、『 API リファレンス』を参照してください。 Place の結果にはマップ ビューがないことに注意してください。
View.Result[].Location. Address.Label items[].address.label アドレスラベルの形式は、 HERE Geocoder API で使用されている形式とは異なる場合があります。特に、建物名には二重引用符は使用されません。
View.Result[].Location. Address.Country items[].address.countryCode GS7 countryNamecountryCode では、フィールドに国名、フィールドに国コードが返されます。
View.Result[].Location. Address.State items[].address.state, items[].address.stateCode GS7 statestateCode は、フィールドに状態名を返し、フィールドには状態コード ( 一般的に使用されている場合 ) を返します。
View.Result[].Location. Address.County items[].address.county, items[].address.countyCode GS7 countycountyCode では、フィールドに郡名が、一般的に使用されている国コードがフィールドに返されます。
View.Result[].Location. Address.City items[].address.city
View.Result[].Location. Address.District items[].address.district
View.Result[].Location. Address.Subdistrict items[].address.subdistrict
View.Result[].Location. Address.Street items[].address.street, items[].address.streets 自宅番号または番地の結果については street. 、 GS7 streets が交差点結果のフィールドに単一の番地を返し、 GS7 は配列内の通り名のリストを返します ( 複数形 ) 。
View.Result[].Location. Address.HouseNumber items[].address.houseNumber
View.Result[].Location. Address.PostalCode items[].address.postalCode
View.Result[].Location. Address.Building items[].address.building
View.Result[].Location.Address .AdditionalData[Country2] items[].countryInfo.alpha2
View.Result[].Location.Address .AdditionalData[CountryName] items[].address.countryName GS7 countryNamecountryCode では、フィールドに国名、フィールドに国コードが返されます。
View.Result[].Location.Address .AdditionalData[StateName] items[].address.state GS7 statestateCode は、フィールドに状態名を返し、フィールドには状態コード ( 一般的に使用されている場合 ) を返します。
View.Result[].Location.Address .AdditionalData[CountyName] items[].address.county GS7 countycountyCode では、フィールドに郡名が、一般的に使用されている国コードがフィールドに返されます。
View.Result[].Location.Address .AdditionalData[<secondary address units>] items[].parsing.secondaryUnits GS7 /geocode では、検出されたセカンダリユニットデジグネータがparsingブロックに含まれています。
View.Result[].Location. AddressDetails.StreetDetails items[].streetInfo
View.Result[].AdditionalData [houseNumberFallback] items[].houseNumberFallback
世代 = 9 :View.Result[].adminInfo.timeZone、世代 <9 : View.Result[].adminInfo.timeZoneOffset items[].timeZone リプレゼンテーションが変更されました。 詳細については 、『 API リファレンス』を参照してください。 タイムゾーンの名前と UTC オフセット 以外のタイムゾーン固有の詳細情報が必要な場合は、タイムゾーンの名前と、クライアントのソフトウェアスタックに適したライブラリ のヘルプから取得できます。

現在サポートされていません

GS7 ジオコードサービスでは、現在次のクエリーパラメータはサポートされていません。

HERE Geocoder API コメント
additionaldata=AdditionalAddressProvider
additionaldata=AddressRangeSqueezeFactor
additionaldata=AddressRangeSqueezeOffset
additionaldata=CrossingStreets
additionaldata=FlexibleAdminValues GS7 /geocode では、既定で柔軟な管理者値がサポートされていますが、クエリスコアにはペナルティがあります。
additionaldata=HouseNumberMode GS7 /geocode は常に自宅番号のフォールバックモードで動作します。次に近い自宅番号へのフォールバックは、事前に定義された最大自宅番号の距離内で実行されます。
additionaldata=IncludeChildPOIs
additionaldata=IncludeDistanceMarkers 該当なし
additionaldata=IncludeMicroPointAddresses
additionaldata=IncludeRoutingInformation
additionaldata=IncludeShapeLevel
additionaldata=IncludeZipAddOn GS7 /geocode では、 USA ZIP+4 の郵便番号拡張子が常に追加されます ( 利用可能な場合 ) 。この拡張子は郵便番号に適用されます。
additionaldata=IntersectionSnapTolerance 該当なし
additionaldata=NormalizeNames
additionaldata=RestrictLevel 該当なし
additionaldata=SuppressStreetType 該当なし
addressattributes GS7 /geocode では、アドレス属性のセットが修正されています。 含まれるもの : 国、州、郡、都市、区、 サブ地区、番地、ハウス番号、郵便番号 ; 国、 additionalData の州名と郡名。 addressLines 、 additionalData の他の要素は含まれません。
app_code GS7 認証では、 app_id/app_code メソッドはサポートされていません。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。
app_id GS7 認証では、 app_id/app_code メソッドはサポートされていません。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。
bbox GS7 /geocode は空間フィルターをサポートしていません。 at 空間参照にはパラメータを使用します。
categoryids GS7 /geocode では、カテゴリ ID によるフィルタリングはサポートされていません
gen
jsonattributes
jsoncallback
locationattributes.address ()ar GS7 /geocode の結果には、常に住所情報が含まれています。
locationattributes.mapReference ()mr GS7 /geocode は地図参照情報をサポートしていません。
locationattributes.mapView ()mv GS7 /geocode の結果には、 Place の結果を除き、常にマップビューの情報が含まれています。
locationattributes.addressDetails ()dt GS7 /geocode は住所の詳細情報をサポートしていません。
locationattributes.additionalData ()ad GS7 /geocode では、位置情報の追加データ(ExtendedTopLeftLatitudeExtendedTopLeftLongitudeExtendedBottomRightLatitudeExtendedBottomRightLongitudeadditionalAddressProvider)はサポートされていません。
locationattributes.adminIds ()ai GS7 /geocode では、結果的に管理 ID は提供されません。
locationattributes.linkInfo ()li GS7 /geocode では、結果としてリンク情報は提供されません。
locationattributes.adminInfo ()in GS7 /geocode では、結果として追加の管理情報は提供されません。
locationattributes.addressNamesBilingual ()nb GS7 /geocode では、バイリンガルの住所名は提供されていません。
locationattributes.related.nearByAddress ()rn GS7 /geocode では、その結果、近くの場所は提供されません。
locationattributes.all
locationattributes.none
locationid GS7 /lookup エンドポイントを使用して、 ID を使用して結果を取得します。 HERE Geocoder API の場所 ID と GS7 の ID の形式が異なり、互換性がありません。
mapview GS7 /geocode は空間フィルターをサポートしていません。 at 空間参照にはパラメータを使用します。
name GS7 /geocode では、修飾クエリのサブパラメータとしての Place 名はサポートされていません。 ランドマーク名は q 、パラメータの freeform 検索テキスト内に入力できます。
pageinformation GS7 には、複数の応答ページの概念はありません。 limit このパラメータでは、結果の合計数を制限します。
responseattributes.performedSearch ()ps GS7 /geocode では、応答属性のセットが修正されています。 実行された検索情報はサポートされていません。
responseattributes.matchQuality ()mq GS7 /geocode では、応答属性のセットが修正されています。 一致精度の値は、に含ま fieldScoreれています。
responseattributes.matchType ()mt GS7 /geocode では、応答属性のセットが修正されています。 一致タイプはに含ま houseNumberTypeれています。
responseattributes.matchCode ()mc GS7 /geocode では、応答属性のセットが修正されています。 一致コードはサポートされていません。
responseattributes.all GS7 /geocode では、応答属性のセットが修正されています。
responseattributes.none GS7 /geocode では、応答属性のセットが修正されています。
street0 GS7 /geocode では、道路の交差点を freeform テキストで入力できます。 または、交差するすべての道路を 1 つの認定フィールドで指定することも streetできます。 GS7 /geocode では、複数の道路フィールドでの道路の交差点の入力はサポートされていません。
street1 GS7 /geocode では、複数の道路フィールドでの道路の交差点の入力はサポートされていません。
strictlanguagemode
token 詳細について は、『 Identity & Access Management 開発者ガイド』を参照してください。

次の応答属性は、現在 GS7 ジオコードサービスから返されていません。

HERE Geocoder API コメント
MetaInfo GS7 の応答には、メタ情報 (,,,request) は含まRequestIdTimestampNextPageInformationPreviousPageInformationAdditionalDataれていません。
View GS7 の回答では、結果の項目リストよりも上のレベルには追加されません。
View.PerformedSearch
View.Result[].Direction
View.Result[].MatchCode
View.Result[].Location.Shape
View.Result[].Location. Address.DistanceMarker GS7 /geocode は距離マーカーをサポートしていません。
View.Result[].Location. Address. AddressLine
View.Result[].Location.Address .AdditionalData[CrossingStreet0]
View.Result[].Location.Address .AdditionalData[CrossingStreet1]
View.Result[].Location.Address .AdditionalData[PostalCodeType]
View.Result[].Location. AddressDetails.CountryCode GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.Country GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.State GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.County GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.City GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.District GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.Street GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.HouseNumber GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.PostalCode GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressDetails.Building GS7 /geocode は住所の詳細情報をサポートしていません。
View.Result[].Location. AddressNames GS7 /geocode は、追加の住所名を返しません。
View.Result[].Location.MapReference GS7 /geocode はマップ参照を返しません。
View.Result[].Location.LinkInfo GS7 /geocode では、応答にリンク情報は含まれていません。
View.Result[].Location.AdminInfo GS7 /geocode では、管理者情報は応答に含まれません。
View.Result[].Location.Related GS7 /geocode は関連する場所をサポートしていません。
View.Result[].Location. AdditionalData GS7 /geocode では、位置情報の追加データ(ExtendedTopLeftLatitudeExtendedTopLeftLongitudeExtendedBottomRightLatitudeExtendedBottomRightLongitudeadditionalAddressProvider)はサポートされていません。
View.Result[].Place GS7 /geocode は、 Place の結果も返します。 詳細については 、「結果タイプ」を参照してください。
View.Result[].AdditionalData [houseNumberFallbackDifference] 冗長として削除されました。 リクエストされた自宅番号と一致した自宅番号の差は、 items[].scoring.fieldScore.houseNumber から取得できます。
View.Result[].AdditionalData [houseNumberExtrapolation] 削除されました GS7 /geocode は、番地外挿モードをサポートしていません。
View.Result[].AdditionalData [houseNumberExtrapolationDistance] 削除されました GS7 /geocode は、番地外挿モードをサポートしていません。
View.Result[].AdditionalData [houseNumberExtrapolationDifference] 削除されました GS7 /geocode は、番地外挿モードをサポートしていません。

」に一致する結果は 件です

    」に一致する結果はありません