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 .
Квоты и цены
Просмотрите страницу использования и выставления счетов , чтобы узнать подробности о квотах и ценах, установленных для Geocoding API.
Политики
Использование API геокодирования должно осуществляться в соответствии с политиками API .
Учить больше
С API геокодирования вы можете делать больше. Дополнительные демонстрации, примеры, доступные параметры, коды состояния и сообщения об ошибках, а также другие сведения см. в руководстве разработчика API геокодирования .
В руководстве разработчика API геокодирования описывается веб-служба API геокодирования. Он предназначен для разработчиков веб-сайтов и мобильных устройств, которые хотят использовать данные геокодирования на картах, предоставляемых одним из API платформы Google Maps.