Geocoding API — это сервис, обеспечивающий геокодирование и обратное геокодирование адресов.
Геокодирование — это процесс преобразования адресов (например, почтовых адресов) в географические координаты (например, широту и долготу), которые можно использовать для размещения маркеров на карте или позиционирования карты.
Обратное геокодирование — это процесс преобразования географических координат в понятный человеку адрес.
Вы также можете использовать API геокодирования, чтобы найти адрес для заданного идентификатора места .
Образец запроса и ответа
Вы получаете доступ к Geocoding 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 Client, Python Client, Go Client и Node.js Client для Google Maps Services .
Аутентификация, квоты, ценообразование и политики
Аутентификация
Чтобы использовать Geocoding API, необходимо сначала включить API и получить соответствующие учетные данные аутентификации. Для получения дополнительной информации см. Get Started with Google Maps Platform .
Квоты и ценообразование
Подробную информацию о квотах и ценах на API геокодирования можно найти на странице использования и выставления счетов .
Политики
Использование API геокодирования должно осуществляться в соответствии с политиками API .
Узнать больше
С Geocoding API можно сделать больше. Дополнительные демонстрации, примеры, доступные параметры, коды состояния и сообщения об ошибках, а также другие подробности см. в руководстве разработчика Geocoding API.
Руководство разработчика API геокодирования описывает веб-сервис API геокодирования. Он предназначен для разработчиков веб-сайтов и мобильных приложений, которые хотят использовать данные геокодирования в картах, предоставляемых одним из API платформы Google Maps.