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.
- Konum için coğrafi kod oluşturma: 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 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. |
Kullanıma sunma aşaması kanalları
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 Hedefler 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ı başlıklı makaleyi 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 varış noktaları 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 taraflı ç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.