역 지오코딩 주소 설명자 요청 및 응답

주소 설명어는 랜드마크와 지역을 사용하여 위도와 경도 좌표를 설명하는 데 도움이 되는 표준 역 지오코딩 응답에 추가 정보를 반환합니다. API를 살펴보려면 주소 설명자 데모를 확인하세요.

역 지오코딩 요청 - 추가 매개변수

선택적 매개변수

다음은 역 지오코딩 요청에 포함할 수 있는 선택적 매개변수입니다.

역 지오코딩의 예

다음 쿼리에는 델리의 한 위치의 위도/경도 값이 포함되어 있습니다.

https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true

응답

위 쿼리는 다음과 같이 추가 address_descriptor를 반환합니다.

{
  "address_descriptor" : {
     "areas" : [
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Turkman Gate"
           },
           "place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
        },
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Chandni Chowk"
           },
           "place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
        },
        {
           "containment" : "NEAR",
           "display_name" : {
              "language_code" : "en",
              "text" : "Katar Ganj"
           },
           "place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
        }
     ],
     "landmarks" : [
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delite Cinema"
           },
           "straight_line_distance_meters" : 29.9306755065918,
           "place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
           "travel_distance_meters" : 418.7794799804688,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "establishment", "movie_theater", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "YES Bank"
           },
           "straight_line_distance_meters" : 66.83731079101562,
           "place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
           "travel_distance_meters" : 489.0340270996094,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "UCO Bank"
           },
           "straight_line_distance_meters" : 25.38849639892578,
           "place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
           "travel_distance_meters" : 403.2246398925781,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delhi By Cycle Meeting Point"
           },
           "straight_line_distance_meters" : 44.02867126464844,
           "place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
           "travel_distance_meters" : 97.41281890869141,
           "spatial_relationship" : "AROUND_THE_CORNER",
           "types" : [
              "establishment",
              "point_of_interest",
              "tourist_attraction",
              "travel_agency"
           ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Axis Bank Branch"
           },
           "straight_line_distance_meters" : 102.3495178222656,
           "place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
           "travel_distance_meters" : 330.8566284179688,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        }
     ]
  },
 ... Results (reverse geocoding response) ...

address_descriptor 객체에는 두 개의 배열(landmarksareas)이 있습니다. landmarks 배열에는 요청된 좌표와의 근접성, 랜드마크의 보급률 및 가시성을 고려하여 관련성 순으로 순위가 지정된 최대 5개의 결과가 포함됩니다. 각 랜드마크 결과에는 다음 값이 포함됩니다.

  • place_id는 명소 결과의 장소 ID입니다. 장소 ID 개요를 참고하세요.
  • display_name는 랜드마크의 표시 이름이며 language_codetext를 포함합니다.
  • straight_line_distance_meters는 입력 좌표와 랜드마크 결과 사이의 점 간 거리(미터)입니다.
  • travel_distance_meters은 도로망을 통해 입력된 좌표와 명소 결과 사이의 거리 (도로 제한사항 무시)를 미터 단위로 나타낸 것입니다.
  • spatial_relationship는 입력 좌표와 랜드마크 결과 간의 추정 관계입니다.
    • "NEAR"는 다음 중 어느 것도 적용되지 않는 경우 기본 관계입니다.
    • 입력 좌표가 랜드마크와 연결된 구조체의 경계 내에 포함된 경우 "WITHIN"
    • 입력 좌표가 랜드마크 또는 랜드마크의 액세스 포인트에 직접 인접한 경우 "BESIDE".
    • 입력 좌표가 경로의 반대편에 있는 랜드마크와 정반대일 때 "ACROSS_THE_ROAD"입니다.
    • 입력 좌표가 랜드마크와 동일한 경로에 있지만 "BESIDES" 또는 "ACROSS_THE_ROAD"가 아닌 경우 "DOWN_THE_ROAD"
    • 입력 좌표가 명소로서 수직 경로를 따라 있는 경우 "AROUND_THE_CORNER"입니다 (단일 턴으로 제한).
    • "BEHIND": 입력 좌표가 공간적으로 랜드마크에 가깝지만 액세스 포인트에서 멀리 떨어져 있는 경우
  • types는 명소의 장소 유형입니다.

areas 객체는 최대 3개의 응답을 포함하며 동네, 하위 지역, 대규모 단지와 같이 작은 지역을 나타내는 장소로 제한됩니다. 요청된 좌표가 포함된 영역이 먼저 나열되고 가장 작은 것에서 가장 큰 순으로 정렬됩니다. 각 areas 결과에는 다음 값이 포함됩니다.

  • place_id는 지역 결과의 장소 ID입니다. 장소 ID 개요를 참고하세요.
  • display_name은 영역의 표시 이름이며 language_codetext를 포함합니다.
  • containment은 입력 좌표와 영역 결과 간의 예상 포함 관계입니다.
    • "NEAR"는 다음 중 어느 것도 적용되지 않는 경우 기본 관계입니다.
    • "WITHIN": 입력 좌표가 영역의 중심에 가까운 경우
    • "OUTSKIRTS": 입력 좌표가 영역의 가장자리에 가까운 경우

범위

이 기능은 일부 국가에서만 사용할 수 있습니다.

의견

이 기능은 실험 단계이며, 의견을 보내주시면 감사하겠습니다. address-descriptors-feedback@google.com으로 이메일을 보내주세요.