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, enlem ve boylam koordinatlarını veya bir yer kimliğini ise adrese dönüştürür.
Geocoding API ile yapabilecekleriniz
Aşağıdakiler de dahil olmak üzere bir veya daha fazla adres ya da yer için coğrafi kodlama verileri almak üzere Geocoding API'yi kullanabilirsiniz:
Geocoding API v4'ün bu sürümü aşağıdaki uç noktaların yayınlanmasını içerir:
- (Önizleme) Adresleri coğrafi olarak kodlama: Adreslerin coğrafi koordinatları. İleri coğrafi kodlama olarak da adlandırılır.
- (Önizleme) Bir konuma coğrafi kod atama — Enlem ve boylam koordinatları kümeleri için adresler. Tersine coğrafi kodlama olarak da bilinir.
- (Önizleme) Yer coğrafi kodlama — Bir yer kimliğinden adres alma.
- (Önizleme) Hedef arama — Adres, yer kimliği veya konuma göre hedef arayı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.
Geocoding API'nin işleyiş şekli
Geocoding API hem coğrafi kodlama hem de tersine coğrafi kodlama yapar:
- Coğrafi kodlama: "1600 Amphitheatre Parkway, Mountain View, CA" gibi adresleri enlem ve boylam koordinatlarına veya yer kimliklerine dönüştürür. Bu koordinatları, haritaya işaretçi yerleştirmek veya haritayı görünüm çerçevesi içinde ortalamak ya da yeniden konumlandırmak için kullanabilirsiniz.
- Ters coğrafi kodlama: Enlem ve boylam koordinatlarını veya bir yer kimliğini okunabilir bir adrese dönüştürür. Adresleri teslimat veya teslim alma gibi çeşitli senaryolarda kullanabilirsiniz.
Aşağıdaki tabloda, Geocoding API aracılığıyla kullanılabilen kaynaklar ve her uç noktanın döndürdüğü veriler özetlenmiştir.
| Veri kaynakları | Döndürülen veriler | Dönüş biçimi |
|---|---|---|
| Coğrafi Kodlama | Adresi, adres bileşenlerini ve adres türlerini döndürür. Geocode yanıtı belgelerini inceleyin. |
|
| Tersine coğrafi kodlama | Adresi, adres bileşenlerini ve adres türlerini döndürür. Tersine coğrafi kodlama yanıtı belgelerini inceleyin. | |
| Yer coğrafi kodlama | Adresi, adres bileşenlerini ve adres türlerini döndürür. Yer coğrafi kodlama yanıtı belgelerine bakın. | |
| Hedef arama | Adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgiler döndürür. Hedef arama belgelerini inceleyin. |
Geocoding API v4'teki özellikler
Geocoding API'nin 4. sürümünde aşağıdaki yeni özellikler sunulmaktadır.
Hedef arama uç noktası
v4, 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 Hedef arama uç noktası sunar. Yanıtta, yapay zeka destekli özetler ve navigasyon noktası jetonları yer alıyor. Bu jetonlar, Navigation SDK'ya iletilebilecek bağlamsal bilgiler içeriyor ve bu sayede rota oluşturma işlemi hassas bir şekilde yapılabiliyor.
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. Bir adrese coğrafi kod, Bir konuma coğrafi kod ve Yer coğrafi kodlama uç noktaları için yanıt nesnesindeki tüm alanlar varsayılan olarak döndürülür. Search for destinations uç noktası için API isteğinde bir alan maskesi belirtmeniz gerekir.
Önizleme döneminde kullanım ücretsizdir.
Geocoding API v4, GA öncesi önizleme aşamasındadır ve önizleme sırasında API kullanımı ücretsizdir. API çağrıları Cloud Console'daki Faturalandırma sayfasında görünür ancak ücretler 0 ABD doları olur.
Geri bildirim
Bu bir önizleme özelliğidir. Geri bildirimlerinizi geocoding-feedback-channel@google.com adresine gönderebilirsiniz.