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 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:
- Adreslerin coğrafi kodunu belirleme — Adreslerin coğrafi koordinatları. İleriye doğru coğrafi kodlama olarak da adlandırılır.
- Bir konumu coğrafi olarak kodlama : Enlem ve boylam koordinat kümelerinin adresleri. Tersine coğrafi kodlama olarak da adlandırılır.
- Yer coğrafi kodlama : Bir yer kimliğinden adres alma.
- Varış noktası arama : Adres, yer kimliği veya konuma göre varış noktası 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ı kullanarak haritaya işaretçi yerleştirebilir veya haritayı görüntüleme çerçevesinde ortalayabilir ya da yeniden konumlandırabilirsiniz.
- Tersine coğrafi kodlama: Enlem ve boylam koordinatlarını veya yer kimliğini, kullanıcıların okuyabileceği bir adrese dönüştürür. Adresleri, teslimat veya teslim alma gibi çeşitli senaryolar için 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. Coğrafi kod 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ı belgelerine bakın. | |
| 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 varış noktaları hakkında ayrıntılı bilgi döndürür. Varış noktası arama belgelerine 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.