주소 설명자 요청 및 응답

유럽 경제 지역 (EEA) 개발자

주소 설명자에는 명소와 지역을 사용하여 위치를 설명하는 데 도움이 되는 추가 정보가 포함됩니다. 주소 설명자 데모 를 확인하여 이 기능을 살펴보세요.

추가 매개변수

주소 설명자는 extra_computations 매개변수를 사용하여 사용 설정할 수 있습니다. 지오코딩 요청, 역지오코딩 요청 또는 장소 지오코딩 요청에 extra_computations=ADDRESS_DESCRIPTORS를 포함하여 응답에서 주소 설명자를 수신합니다.

지오코딩의 예

다음 쿼리에는 델리의 장소 주소가 포함되어 있습니다.

https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

장소 지오코딩의 예

다음 쿼리에는 델리의 장소 ID가 포함되어 있습니다.

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

역지오코딩의 예

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

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

응답

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

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

  • place_id는 명소 결과의 장소 ID입니다. 장소 ID 개요를 참고하세요.
  • display_name은 명소의 표시 이름이며 language_code와 text를 포함합니다.
  • straight_line_distance_meters는 입력 좌표와 명소 결과 간의 점대점 거리(미터)입니다.
  • travel_distance_meters는 입력 좌표와 명소 결과 간의 도로망을 통해 이동한 거리(미터)(도로 제한 무시)입니다.
  • spatial_relationship은 입력 좌표와 명소 결과 간의 예상 관계입니다.
    • "NEAR"는 다음 중 어느 것도 적용되지 않는 경우의 기본 관계입니다.
    • "WITHIN"은 입력 좌표가 명소와 연결된 구조의 경계 내에 포함된 경우입니다.
    • "BESIDE"는 입력 좌표가 명소 또는 명소의 액세스 포인트에 직접 인접한 경우입니다.
    • "ACROSS_THE_ROAD"는 입력 좌표가 경로의 반대편에 있는 명소의 바로 맞은편에 있는 경우입니다.
    • "DOWN_THE_ROAD"는 입력 좌표가 명소와 동일한 경로에 있지만 "BESIDES" 또는 "ACROSS_THE_ROAD"는 아닌 경우입니다.
    • "AROUND_THE_CORNER"는 입력 좌표가 명소와 수직 경로에 있는 경우입니다 (단일 회전으로 제한됨).
    • "BEHIND"는 입력 좌표가 명소와 공간적으로 가깝지만 액세스 포인트와는 먼 경우입니다.
  • types는 명소의 장소 유형입니다.

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

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

적용 범위

주소 설명자는 모든 리전에서 사용할 수 있습니다. 자세한 내용은 리전 적용 범위를 참고하세요.

의견

이 기능은 모든 리전에서 사용할 수 있으며 인도의 경우 GA 단계에 있고 다른 모든 리전의 경우 GA 전 실험 출시 단계에 있습니다. 의견을 보내주시면 감사하겠습니다. address-descriptors-feedback@google.com으로 이메일을 보내주세요.