Geocoding API v4'e genel bakış

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Geocoding API; bir yeri adres, enlem ve boylam koordinatları veya yer kimliği olarak kabul eden bir hizmettir. Adresi enlem ve boylam koordinatlarına ve bir yer kimliğine dönüştürür veya enlem ve boylam koordinatlarını ya da bir yer kimliğini adrese dönüştürür.

Geocoding API v4, hem yakın çevreye özel varış noktası ve varış bilgileri hem de temel koordinat-adres çözünürlüğü sağlar. Son nokta teslimatı, araç paylaşımı veya adım adım rota deneyimi oluştururken ya da açık adresleri koordinatlara dönüştürürken v4, kullanım alanınıza özel uç noktalar sunar.

Uygulamanıza hangi uç noktanın uygun olduğundan emin değil misiniz? Coğrafi kodlama yöntemi seçme bölümüne bakın.

Geocoding API ile yapabilecekleriniz

Geocoding API v4, aşağıdaki özellikleri ve uç noktaları içerir:

  • Hedef arama: Bir adres, yer kimliği veya koordinatlardan bir hedefin yakın çevreye özel varış ayrıntılarını (bina girişleri, rotası çizilebilir navigasyon noktası jetonları, bina ve arazi ana hatları, alt hedefler ve yakındaki önemli noktalar dahil) alın.
  • Bir adresi coğrafi olarak kodlama: Açık adresleri coğrafi koordinatlara ve yer kimliklerine dönüştürün (ileri coğrafi kodlama).
  • Bir konumu coğrafi olarak kodlama: Enlem ve boylam koordinatlarını, okunabilir açık adreslere veya bağlı olduğu yerlere dönüştürün (tersine coğrafi kodlama).
  • Bir yerin coğrafi kodunu alma: Bilinen bir Google Haritalar yer kimliği için biçimlendirilmiş adres ayrıntılarını ve koordinatları alın.

Sonuçların nerede görüneceğini kontrol edebilir ve sonuçları belirli bir bölge, ilçe veya posta koduyla sınırlayabilirsiniz.

Demoyu deneyin

Geocoding API'nin işleyiş şekli

Geocoding API v4, temel coğrafi kodlamanın yanı sıra varış noktası aramayı da destekler:

  • Hedef arama (SearchDestinations): Bir adresi, yer kimliğini veya koordinat çiftini zengin bir Destination nesnesine dönüştürür. Fiziksel varışın önemli olduğu durumlarda bu yöntemi kullanın. Örneğin, tercih edilen bina girişlerini belirleme, sürücüleri navigasyon noktası jetonlarını kullanarak belirlenen teslim alma veya bırakma noktalarına yönlendirme, bina ayak izlerini haritada oluşturma veya birden fazla binadan oluşan komplekslerde gezinme.
  • Temel coğrafi kodlama: Adresler, koordinatlar ve yer kimlikleri arasında dönüşüm yapar:
    • Coğrafi kodlama: "1600 Amphitheatre Parkway, Mountain View, CA" gibi açık adresleri, harita işaretçileri yerleştirmek veya harita görünümü çerçevesini ortalamak için enlem ve boylam koordinatlarına ya da yer kimliklerine dönüştürür.
    • Tersine coğrafi kodlama: Enlem ve boylam koordinatlarını veya yer kimliklerini, kullanıcı tarafından bırakılan harita raptiyeleri, konum seçiciler ya da kullanıcı arayüzü ekranı için okunabilir açık adreslere dönüştürür.
    • Yer coğrafi kodlama: Bilinen bir Google Haritalar yer kimliği için adres ayrıntılarını ve koordinatları alır.

Aşağıdaki tabloda, Geocoding API v4 aracılığıyla kullanılabilen kaynaklar ve her yöntemin döndürdüğü veriler özetlenmiştir:

Veri kaynakları Döndürülen veriler Dönüş biçimi
Varış noktası arama
(POST /v4/geocode/destinations) 		Yakın çevreye özel varış bilgileri döndürür: bina ve arazi poligonları (displayPolygon), fiziksel entrances, rotası çizilebilir navigationPoints (jetonlarla), hiyerarşik containingPlaces ve subDestinations, ilişkisel landmarks ve birincil yer ayrıntıları. Varış noktası arama başlıklı makaleyi inceleyin.
  • JSON
Bir adresi coğrafi olarak kodlama
(GET /v4/geocode/address) 		Adresi, adres bileşenlerini ve adres türlerini döndürür. Coğrafi kod yanıtı bölümüne bakın.
Bir konumu coğrafi olarak kodlama
(GET /v4/geocode/location) 		Adresi, adres bileşenlerini ve adres türlerini döndürür. Tersine coğrafi kodlama yanıtı bölümüne bakın.
Bir yerin coğrafi kodunu oluşturma
(GET /v4/geocode/places) 		Adresi, adres bileşenlerini ve adres türlerini döndürür. Yer coğrafi kodlama yanıtı bölümüne bakın.

Sahne kanallarını başlatma

Geocoding API'nin 4. sürümünde GA, önizleme ve deneysel özellikler için ayrı kanallar bulunur. Önizleme veya deneysel özellikleri kullanmak istiyorsanız isteğinizde doğru kanalı belirttiğinizden emin olun. Örneğin, deneysel sürümdeki Destinations uç noktasının özelliklerine erişmek için şu HTTP isteğini kullanın: https://geocode.googleapis.com/v4alpha/geocode/destinations.

Başlatma aşaması Kanal adı
YG /v4/
Önizleme /v4beta/
Deneysel /v4alpha/
  • Kullanılabilir tüm REST kaynaklarının listesi ve açıklaması için REST referansına bakın.
  • Her aşama hakkında daha fazla bilgi için lansman aşamaları bölümüne bakın.

Geocoding API v4'teki özellikler

Geocoding API'nin 4. sürümü bu yeni özellikleri sunar.

Hedef arama yöntemi

Sürüm 4'te, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli varış noktaları hakkında ayrıntılı bilgi almanızı sağlayan bir Destination search yöntemi sunulmaktadır. Yanıtta, hassas rota çizimi için Navigation SDK'ya iletilebilecek bağlamsal bilgiler içeren yapay zeka destekli özetler ve navigasyon noktası jetonları yer alır.

Google Cloud standart platformunda uygulanır.

Geocoding API v4, Google Cloud'daki hizmet altyapısında uygulanır. Bu uygulama, OAuth gibi gelişmiş güvenlik seçenekleriyle daha güvenli ve güvenilir bir platform sunar. Bu standart API tasarımı, API'ler arasında tutarlılık sağlayarak Geocoding API v4 ile geliştirme verimliliğini artırır.

OAuth desteği eklendi

Geocoding API v4, kimlik doğrulama için OAuth 2.0 kullanımını destekler. Google, web sunucusu gibi yaygın OAuth 2.0 senaryolarını destekler.

Alan maskesi desteği eklendi

Yanıtın hangi bilgileri döndürmesi gerektiğini belirtmek için alan maskelerini kullanın. Adresi coğrafi olarak kodlama, Konumu coğrafi olarak kodlama ve Yeri coğrafi olarak kodlama yöntemlerinde, yanıt nesnesindeki tüm alanlar varsayılan olarak döndürülür. Search for destinations yöntemi için API isteğinde bir alan maskesi belirtmeniz gerekir.

API güvenliği

Geocoding API v4, sunucudan sunucuya API olarak tasarlanmıştır. HTTP yönlendiren kısıtlamaları, web hizmeti uç noktaları için yeterli koruma sağlamadığından tarayıcıdan yapılan doğrudan istemci tarafı çağrılar, API anahtarlarını önemli ölçüde hırsızlık ve kötüye kullanım riskine maruz bırakır.

Geocoding API v4'ü kendi arka uç sunucunuzdan çağırmanızı önemle tavsiye ederiz. Güvenli uygulama kalıpları ve istemci tarafı ihtiyaçlarına yönelik alternatifler hakkında daha fazla bilgi için Güvenlikle ilgili dikkat edilmesi gereken noktalar başlıklı makaleyi inceleyin.