レスポンス言語

HERE Geocoding and Search は、ユーザーが読み取ることができる結果を提供することを目的としています。 これを実現するために、 HERE Geocoding and Search はユーザーが指定した言語で各結果を返します。 または、ユーザーが応答言語を指定していない場合、 HERE Geocoding and Search は結果ごとにその既定の言語を使用します。 HERE Geocoding and Search は、すべての住所要素を同じ言語で返します ( 利用可能な場合 ) 。

この項は、 autocompleteを除くすべてのエンドポイントに適用されます。 詳細については、Autocompleteを参照してください。

既定の言語

ユーザーが応答言語を指定しない場合、 HERE Geocoding and Search は現地の人々の好みを反映することを目的としています。結果はその国の公用語で返されます。 主要な地域言語がその国の公用語と異なる地域では、 HERE Geocoding and Searchはその地域を言語を選択します。

次の例では、ギリシャの首都を英語で検索しています。 ユーザーが優先応答言語を指定していません :

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=Athens
    &apiKey={YOUR_API_KEY}

HERE Geocoding and Search はギリシャの公用語であるギリシャ語で結果を返します。

{
  "items": [
    {
      "title": "Αθήνα, Αττική, Ελλάδα",
      "id": "here:cm:namedplace:20493491",
      "resultType": "locality",
      "localityType": "city",
      "address": {
        "label": "Αθήνα, Αττική, Ελλάδα",
        "countryCode": "GRC",
        "countryName": "Ελλάδα",
        "state": "Αττική",
        "county": "Αττική",
        "city": "Αθήνα",
        "postalCode": "114 72"
      },
      "position": {
        "lat": 37.97614,
        "lng": 23.7364
      },
      "mapView": {
        "west": 23.68693,
        "south": 37.94882,
        "east": 23.78976,
        "north": 38.03343
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1
        }
      }
    }
  ]
}

Languageパラメータ

すべての HERE Geocoding and Search エンドポイントが lang このパラメータをサポートしています。 このパラメータを使用すると、ユーザーは結果の優先言語を設定できます。 言語コードは、 RFC 4647 標準に準拠して提供する必要があります。

たとえば、ユーザーがすべての結果を US English で参照することを希望する場合、クエリには 次のものlang=en-USが含まれます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=Athens
    &lang=en-US
    &apiKey={YOUR_API_KEY}

HERE Geocoding and Search は結果を英語で返します。

{
  "items": [
    {
      "title": "Athens, Attiki, Greece",
      "id": "here:cm:namedplace:20493491",
      "resultType": "locality",
      "localityType": "city",
      "address": {
        "label": "Athens, Attiki, Greece",
        "countryCode": "GRC",
        "countryName": "Greece",
        "state": "Attiki",
        "county": "Attiki",
        "city": "Athens",
        "postalCode": "114 72"
      },
      "position": {
        "lat": 37.97614,
        "lng": 23.7364
      },
      "mapView": {
        "west": 23.68693,
        "south": 37.94882,
        "east": 23.78976,
        "north": 38.03343
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1
        }
      }
    }
  ]
}

言語のフォールバックのルール

HERE Geocoding and Search の主な目標の 1 つは、ユーザーが認識して理解できる言語とスクリプトで結果を提供することです。

要求された言語で一部の住所要素が使用できない場合、 HERE Geocoding and Search は既定の言語で住所要素を返します。

ただし、結果の既定の言語にラテン文字が含まれておらず、このスクリプトが要求された言語のスクリプトと異なる場合、 HERE Geocoding and Search では、ラテン文字 ( 国の既定または主要な地域言語の音訳形式 ) が優先されます。

たとえば、ユーザーがアテネの地図上のポイントを選択し、最も近い住所を検索しようとしていますが、結果を US English で参照することを希望しています。

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=37.9782386%2C23.7411506
    &lang=en-US
    &apiKey={YOUR_API_KEY}

マップ データでは、国名と大文字の都市名の英語訳を提供しています。 HERE Geocoding and Search は英語で返します。 通りにはギリシャ語表記しかありません。 ギリシャ語のスクリプトをエンドユーザーが読むことは困難な場合があります。そのため、 HERE Geocoding and Search はギリシャの通りの名前はラテン語の音訳形式が返されます。

{
  "items": [
    {
      "title": "10 Anagnostopoulou, 106 73 Athens, Greece",
      "id": "here:af:streetsection:5dzDHBBJbqLpCXyCNTJLUA:CggIBCCO9enIAhABGgIxMA",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "10 Anagnostopoulou, 106 73 Athens, Greece",
        "countryCode": "GRC",
        "countryName": "Greece",
        "state": "Attiki",
        "county": "Attiki",
        "city": "Athens",
        "district": "Athens",
        "street": "Anagnostopoulou",
        "postalCode": "106 73",
        "houseNumber": "10"
      },
      "position": {
        "lat": 37.97825,
        "lng": 23.74117
      },
      "access": [
        {
          "lat": 37.97817,
          "lng": 23.741
        }
      ],
      "distance": 2,
      "mapView": {
        "west": 23.73927,
        "south": 37.97765,
        "east": 23.74138,
        "north": 37.98036
      }
    }
  ]
}