Interfejs Geocoding API to usługa oferująca geokodowanie i odwrotne geokodowanie adresów.
Geokodowanie to proces konwertowania adresów (np. adresów). według współrzędnych geograficznych (takich jak szerokość i długość geograficzna), których można używać do umieszczania znaczników na mapie lub ustawić położenie na mapie.
Odwrotne geokodowanie to proces konwertowania współrzędnych geograficznych. w adres zrozumiały dla człowieka.
Można także użyć interfejsu Geocoding API do znalezienia adresu podany identyfikator miejsca.
Przykładowe żądanie i odpowiedź
Dostęp do interfejsu Geocoding API uzyskuje się przez interfejs HTTP. Obserwujesz to przykłady żądań geokodowania i odwrotnego geokodowania.
Żądanie i odpowiedź geokodowania (wyszukiwanie szerokości i długości geograficznej)
W poniższym przykładzie należy podać długość i szerokość geograficzną miejsca „1600 Amphitheatre Parkway” Parkway, Mountain View, CA” oraz wskazuje, ż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 w przeglądarce adres URL (pamiętaj, aby zastąpić
YOUR_API_KEY rzeczywistym kluczem interfejsu API).
Odpowiedź zawiera szerokość i długość geograficzną adresu.
Zapoznaj się z przewodnikiem dla programistów . tworzenia adresów URL żądań geokodowania oraz dostępne parametry i zrozumienie odpowiedzi.
Poniżej znajdziesz przykładową odpowiedź na potrzeby 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 i odpowiedź geokodowania (wyszukiwanie adresu)
W poniższym przykładzie należy podać adres odpowiadający danej szerokości/długości geograficznej na Brooklynie, w stanie Nowy Jork, USA. 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 w przeglądarce adres URL (pamiętaj, aby zastąpić „YOUR_API_KEY” rzeczywistym kluczem interfejsu API). Odpowiedź zawiera zrozumiały dla człowieka adres dla szerokości i długości geograficznej. lokalizacji.
Zapoznaj się z przewodnikiem dla programistów . tworząc adresy URL żądań odwrotnego geokodowania dostępne parametry i zrozumienie odpowiedzi.
Poniżej znajdziesz przykładową odpowiedź odwrotną do geokodowania 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ć, korzystając z naszych bibliotek klienta
Biblioteki klienta za pomocą interfejsów API usług sieciowych Map Google, oferując proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, i automatyczne ponawianie próby. Interfejs Geocoding API jest dostępny w Klient Java, Klient Pythona, Klient Go i Klient Node.js dla usług Map Google.
Uwierzytelnianie, limity, ceny i zasady
Uwierzytelnianie
Aby korzystać z interfejsu Geocoding API, musisz najpierw włączyć interfejs API i uzyskać odpowiednie dane uwierzytelniające. Więcej informacji: Pierwsze kroki z Google Maps Platform
Limity i ceny
Zapoznaj się z informacjami o użytkowaniu i płatnościach na stronie zawierającej szczegółowe informacje na temat limitów i cen ustawionych dla interfejsu Geocoding API.
Zasady
Korzystanie z interfejsu Geocoding API musi być zgodne z Zasady dotyczące interfejsu API
Więcej informacji
Interfejs Geocoding API oferuje więcej możliwości. Zobacz Przewodnik dla programistów interfejsu Geocoding API zawierający dodatkowe wersje demonstracyjne, przykłady, dostępne parametry, kody stanu i komunikaty o błędach oraz inne szczegóły.
Przewodnik dla programistów interfejsu Geocoding API zawiera opis Usługa sieciowa Geocoding API. Jest przeznaczona dla programistów stron internetowych i aplikacji mobilnych którzy chcą korzystać z danych geokodowania na mapach udostępnianych przez jedną z Google Maps Platform API.