レスポンス言語

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
        }
      }
    }
  ]
}

言語パラメーター

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

たとえば、ユーザーがすべての結果を米国英語で表示することを希望する場合、クエリには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はその国のデフォルトまたは主要な地域言語を音訳形式にしたラテン文字を優先します。

たとえば、ユーザーがアテネの地図上のポイントを選択し、最も近い住所を検索して、米国英語で結果を表示することを希望しているとします。

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
      }
    }
  ]
}