Начало работы

API геокодирования — это сервис, обеспечивающий геокодирование и обратное геокодирование адресов.

Геокодирование — это процесс преобразования адресов (например, уличного адреса) в географические координаты (например, широту и долготу), которые можно использовать для размещения маркеров на карте или позиционирования карты.

Обратное геокодирование — это процесс преобразования географических координат в удобочитаемый адрес.

Вы также можете использовать API геокодирования, чтобы найти адрес по заданному идентификатору места .

Пример запроса и ответа

Доступ к API геокодирования осуществляется через HTTP-интерфейс. Ниже приведены примеры запросов геокодирования и обратного геокодирования .

Запрос и ответ геокодирования (поиск широты и долготы)

В следующем примере запрашиваются широта и долгота «1600 Amphitheatre Parkway, Mountain View, CA» и указывается, что выходные данные должны быть в формате JSON.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

Вы можете проверить это, введя URL-адрес в свой веб-браузер (обязательно замените YOUR_API_KEY своим фактическим ключом API ). Ответ включает широту и долготу адреса.

Дополнительную информацию о создании URL-адресов запросов геокодирования и доступных параметрах , а также о понимании ответа см. в руководстве разработчика .

Ниже приведен пример ответа на геокодирование в формате JSON:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Parkway",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4267861,
               "lng" : -122.0806032
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4281350802915,
                  "lng" : -122.0792542197085
               },
               "southwest" : {
                  "lat" : 37.4254371197085,
                  "lng" : -122.0819521802915
               }
            }
         },
         "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
         "plus_code" : {
            "compound_code" : "CWC8+R3 Mountain View, California, United States",
            "global_code" : "849VCWC8+R3"
         },
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

Запрос и ответ обратного геокодирования (поиск адреса)

В следующем примере запрашивается адрес, соответствующий заданной широте/долготе в Бруклине, штат Нью-Йорк, США. Он указывает, что выходные данные должны быть в формате JSON.

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

Вы можете проверить это, введя URL-адрес в свой веб-браузер (обязательно замените YOUR_API_KEY своим фактическим ключом API ). Ответ включает удобочитаемый адрес широты и долготы.

Дополнительную информацию о создании URL-адресов запроса обратного геокодирования и доступных параметрах , а также о понимании ответа см. в руководстве разработчика .

Ниже приведен пример ответа обратного геокодирования в формате JSON:

{
   "plus_code" : {
      "compound_code" : "P27Q+MC New York, NY, USA",
      "global_code" : "87G8P27Q+MC"
   },
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "279",
               "short_name" : "279",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Bedford Avenue",
               "short_name" : "Bedford Ave",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Williamsburg",
               "short_name" : "Williamsburg",
               "types" : [ "neighborhood", "political" ]
            },
            {
               "long_name" : "Brooklyn",
               "short_name" : "Brooklyn",
               "types" : [ "political", "sublocality", "sublocality_level_1" ]
            },
            {
               "long_name" : "Kings County",
               "short_name" : "Kings County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "New York",
               "short_name" : "NY",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "11211",
               "short_name" : "11211",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.7142484,
               "lng" : -73.9614103
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.71559738029149,
                  "lng" : -73.9600613197085
               },
               "southwest" : {
                  "lat" : 40.71289941970849,
                  "lng" : -73.96275928029151
               }
            }
         },
         "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
         "plus_code" : {
            "compound_code" : "P27Q+MC Brooklyn, New York, United States",
            "global_code" : "87G8P27Q+MC"
         },
         "types" : [
            "bakery",
            "cafe",
            "establishment",
            "food",
            "point_of_interest",
            "store"
         ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

Начните программировать с помощью наших клиентских библиотек

Клиентские библиотеки упрощают разработку с использованием API веб-служб Google Maps, предоставляя простые, встроенные реализации общих задач, таких как аутентификация, регулирование запросов и автоматические повторы. API геокодирования доступен в клиенте Java, клиенте Python, клиенте Go и клиенте Node.js для служб Google Maps .

Аутентификация, квоты, цены и политики

Аутентификация

Чтобы использовать API геокодирования, необходимо сначала включить API и получить правильные учетные данные для аутентификации. Дополнительную информацию см. в разделе Начало работы с платформой Google Maps .

Квоты и цены

Просмотрите страницу использования и выставления счетов , чтобы получить подробную информацию о квотах и ​​ценах, установленных для API геокодирования.

Политика

Использование API геокодирования должно соответствовать политике API .

Узнать больше

С API геокодирования вы можете сделать больше. См. руководство разработчика API геокодирования для получения дополнительных демонстраций, примеров, доступных параметров, кодов состояния и сообщений об ошибках, а также других подробностей.

В руководстве разработчика API геокодирования описывается веб-служба API геокодирования. Он предназначен для разработчиков веб-сайтов и мобильных устройств, которые хотят использовать данные геокодирования на картах, предоставляемые одним из API платформы Google Maps.