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:
- Adresin coğrafi kodunu belirleme: Adreslerin coğrafi koordinatları. İleri coğrafi kodlama olarak da adlandırılır.
- Konuma coğrafi kod atama: Enlem ve boylam koordinatları kümeleri için adresler. Tersine coğrafi kodlama olarak da bilinir.
- Yer coğrafi kodlama — Bir yer kimliğinden adres alma.
- 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.
Demoyu deneyin
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 yöntemin 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 kodlaması | 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 yöntemi
v4, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgi almanızı sağlayan bir Hedef arama yöntemi sunar. Yanıtta, yapay zeka destekli özetler ve navigasyon noktası jetonları yer alıyor. Bu jetonlar, Navigation SDK'ya aktarılabilen 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 yöntemleri için 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. Tarayıcıdan yapılan doğrudan istemci tarafı çağrıları, HTTP yönlendiren kısıtlamaları web hizmeti uç noktaları için yeterli koruma sağlamadığından API anahtarlarını önemli bir hırsızlık ve kötüye kullanım riskine maruz bırakır.
Coğrafi kodlama API'si 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 hususlar başlıklı makaleyi inceleyin.