Geocoding API to usługa, która zapewnia geokodowanie i odwrotne geokodowanie adresów.
Geokodowanie to proces przekształcania adresów (np. adresów) na współrzędne geograficzne (np. szerokość i długość geograficzną), które można umieścić na mapie lub umieścić ją na mapie.
Odwrotne geokodowanie to proces przekształcania współrzędnych geograficznych w adresy zrozumiałe dla człowieka.
Możesz też użyć interfejsu Geocoding API, aby znaleźć adres identyfikatora miejsca.
Przykładowe żądanie i odpowiedź
Dostęp do interfejsu Geocoding API uzyskuje się przez interfejs HTTP. Oto przykłady żądań geokodowania i odwrotnych geokodów żądań.
Żądanie geograficzne i odpowiedź (wyszukiwanie szerokości i długości geograficznej)
W poniższym przykładzie podano szerokość i długość geograficzną &1600 Amphitheatre Parkway, Mountain View, CA" i określono, że dane wyjściowe muszą być w formacie JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Aby to sprawdzić, wpisz adres URL w przeglądarce (zastąp ciąg YOUR_API_KEY rzeczywistym kluczem interfejsu API).
Odpowiedź zawiera szerokość i długość geograficzną adresu.
Więcej informacji o tworzeniu adresów URL żądań geokodowania i dostępnych parametrach oraz o odpowiedziach znajdziesz w przewodniku dla programistów.
Oto przykładowa odpowiedź geokodowania w formacie 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"
}
Odwrotne żądanie geokodowania i odpowiedź (wyszukiwanie adresu)
Poniższy przykład zawiera żądanie adresu odpowiadającego szerokości i długości geograficznej na Brooklynie w stanie Nowy Jork. Określa, że dane wyjściowe muszą być w formacie JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
Aby to sprawdzić, wpisz adres URL w przeglądarce (zastąp ciąg „YOUR_API_KEY” faktycznym kluczem interfejsu API). Odpowiedź zawiera czytelny dla człowieka adres określający szerokość i długość geograficzną.
Więcej informacji o tworzeniu adresów URL żądań odwrotnego przetwarzania danych i dostępnych parametrów oraz o odpowiedziach znajdziesz w przewodniku dla programistów.
Poniżej znajdziesz przykładową odwrotną transkodowanie geograficzne w formacie 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"
}
Zacznij kodować z naszymi bibliotekami klienta
Biblioteki klienta ułatwiają programowanie za pomocą interfejsów API usługi internetowej Map Google, zapewniając proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań czy automatyczna ponowna próba. Interfejs Geocoding API jest dostępny w wersjach klienta Java, Pythona, Go Client i Node.js dla Map Google.
Uwierzytelnianie, limity, ceny i zasady
Uwierzytelnianie
Aby używać interfejsu Geocoding API, musisz najpierw go włączyć i uzyskać prawidłowe dane uwierzytelniające. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.
Limity i ceny
Szczegółowe informacje o limitach i cenach ustawionych dla interfejsu Geocoding API znajdziesz na stronie użytkowania i rozliczeń.
Zasady
Używanie interfejsu Geocoding API musi być zgodne z zasadami interfejsu API.
Więcej informacji
Więcej możliwości interfejsu Geocoding API. Dodatkowe instrukcje, przykłady, dostępne parametry, kody stanu i komunikaty o błędach znajdziesz w Przewodniku dla programistów korzystających z interfejsu Geocoding API.
Informacje o usłudze internetowej Geocoding API znajdziesz w Przewodniku dla programistów korzystających z interfejsu Geocoding API. Jest przeznaczona dla programistów stron internetowych i urządzeń mobilnych, którzy chcą korzystać z danych geokodowania na mapach dostarczonych przez jeden z interfejsów API Google Maps Platform.