API геокодирования — это служба, которая принимает место в виде адреса, координат широты и долготы или идентификатора места. Он преобразует адрес в координаты широты и долготы и идентификатор места или преобразует координаты широты и долготы или идентификатор места в адрес.
Зачем использовать API геокодирования
Используйте API геокодирования для веб-сайта или мобильного приложения, если вы хотите использовать данные геокодирования на картах, предоставляемых одним из API платформы Google Maps. С помощью API геокодирования вы используете адреса для размещения маркеров на карте или преобразуете маркер на карте в адрес. Этот сервис предназначен для геокодирования предопределенных статических адресов для размещения содержимого приложения на карте.
Что вы можете сделать с помощью API геокодирования
Вы можете использовать API геокодирования для получения данных геокодирования для одного или нескольких адресов или мест, включая следующие:
- Географические координаты адресов.
- Адреса для наборов координат широты и долготы.
- Адреса для идентификаторов мест.
Вы можете контролировать, где будут появляться результаты, и ограничивать их определенным регионом, округом или почтовым индексом.
Как работает API геокодирования
API геокодирования выполняет как геокодирование, так и обратное геокодирование:
- Геокодирование : преобразует такие адреса, как «1600 Amphitheatre Parkway, Mountain View, CA», в координаты широты и долготы или идентификаторы мест. Вы можете использовать эти координаты для размещения маркеров на карте, а также для центрирования или изменения положения карты в рамке просмотра.
- Обратное геокодирование : преобразует координаты широты и долготы или идентификатор места в удобочитаемый адрес. Вы можете использовать адреса для различных сценариев, включая доставку или самовывоз.
В следующей демонстрации используется служба геокодирования через Maps JavaScript API, чтобы продемонстрировать, как работает API геокодирования. Откройте карту в отдельной вкладке, чтобы увидеть больше опций и деталей.
Ресурсы
В следующей таблице приведены ресурсы, доступные через API геокодирования, а также данные, возвращаемые каждой конечной точкой.
| Ресурсы данных | Данные возвращены | Формат возврата |
|---|---|---|
| Геокодирование | Возвращает адрес, компоненты адреса и типы адресов. См. Результаты в руководстве по запросам и ответам на геокодирование . |
|
| Обратное геокодирование | Возвращает адрес, компоненты адреса и типы адресов. См. Ответы на обратное геокодирование в руководстве по запросам и ответам на обратное геокодирование . | |
| Геокодирование места | Возвращает адрес, компоненты адреса и типы адресов. См. Ответы на обратное геокодирование в руководстве Размещение запроса и ответа на геокодирование . |
Как использовать API геокодирования
| 1 | Настройтесь. | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке. |
| 2 | Попробуйте запрос на геокодирование | Получив ключ API, вы можете начать тестирование API геокодирования непосредственно из cURL или браузера. Вам потребуется указать правильные параметры поиска для поиска адресов или компонентов. Подробности см. в разделе Параметры геокодирования . |
| 3 | Попробуйте запрос обратного геокодирования | Укажите координаты широты и долготы вместе с вашим ключом API, чтобы получить компоненты адреса для ближайшего удобочитаемого адреса для этого местоположения. Подробности см. в разделе Запросы обратного геокодирования . |
| 4 | Понимать основы ответа | Все конечные точки в API геокодирования возвращают одни и те же данные в формате JSON или XML. См. ответы геокодирования для объяснения данных, кодов состояния и сообщений об ошибках. |
| 5 | Включите данные геокодирования в свое собственное приложение! | Вы можете использовать данные геокодирования для получения адресов из маркеров карты или для предоставления маркеров на карте на основе известного адреса. |
Доступные клиентские библиотеки
Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для служб Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.
Что дальше
- Начните использовать API геокодирования . Перейдите в раздел «Настройка проекта Google Cloud» .
- Начните работу с примерами запросов и ответов : перейдите к разделу «Запросы и ответы геокодирования».
- Следуйте рекомендациям : перейдите к разделу «Рекомендации по геокодированию адресов» .