Sınırlar için veriye dayalı stil özelliğiyle Yerler hizmetini ve Coğrafi Kodlama API'sini kullanın

Platform seçin: Android iOS JavaScript

Rehber hizmetini ve Bölgeleri aramak üzere Android için Haritalar SDK'sı ile Coğrafi Kodlama API'si ve yerler hakkında daha fazla bilgi almak. Rehber hizmeti Geocoding API ve Geocoding API, 2022'den beri yer kimlikleri. Zaten yer kimlikleri kullanıyorsanız bu kimlikleri sınırlar için veri odaklı stil ile yeniden kullanabilirsiniz.

Android için Haritalar SDK'sına Yerler hizmetini ve Coğrafi Kodlama'yı aşağıdaki yöntemlerle ekleyin:

Yerler hizmetini kullanma

Yer kimliği bulmak için Metin Arama (Yeni) özelliğini kullanma

Alan maskesinde places.id belirterek bölge verilerini içeren bir yer kimliği almak için Places API'deki Text Search (Yeni) REST API'sini kullanabilirsiniz. Metin Arama (Yeni) ile yalnızca yer kimliklerini isteme ücretsiz. Daha fazla bilgi edinin.

Örneğin, Kaliforniya, Trinidad için yer kimliğini almak üzere aşağıdaki API çağrısını yapabilirsiniz:

curl -X POST -d '{
  "textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Bölgeleri bulmak için Yerler Otomatik Tamamlama'yı kullanma

Android için Places SDK'sındaki Yerler Otomatik Tamamlama hizmeti, kullanıcılarınızın bölge aramasını sağlamanın kolay bir yolunu sunar. Yerler Otomatik Tamamlama hizmetini yalnızca bölgeleri döndür, şunu kullanın: AutocompleteSupportFragment.setTypesFilter(List) tuşuna basarak tür filtresini PlaceTypes.REGIONS olarak ayarlayın.

Bir bölgenin yer ayrıntılarını alma

Android için Yerler SDK'sındaki Yer Ayrıntıları hizmeti, bir bölgeyle ilgili veriler döndürerek oldukça faydalı olabilir. Örneğin, şunları yapabilirsiniz:

  • Yer adlarına göre sınır yer kimliklerini arayın.
  • Bir sınırı yakınlaştırmak için görünümü alın.
  • Sınırın özellik türünü alın (örneğin, locality).
  • Amerika Birleşik Devletleri bölgesinde "Yer Adı, Eyalet, Ülke" olarak çözülen biçimlendirilmiş adresi alın (örneğin, "Ottumwa, IA, ABD").
  • Fotoğraflar gibi diğer yararlı verileri alın.

Coğrafi Kodlama API'sini kullanma

Geocoding API, aşağıdaki işlemleri yaparak bir adresi enlem ve boylam koordinatlarına ve Yer Kimliği'ne dönüştürür veya enlem ve boylam koordinatlarını veya Yer Kimliği'ni adrese eklemeyi unutmayın. Aşağıdaki kullanım alanları, sınırlar için veriye dayalı stil ile iyi bir uyum sağlar:

  • Bir bölgenin görüntü alanını almak için Coğrafi Kodlama'yı kullanın.
  • Coğrafi Kodlama çağrınıza bileşen filtrelemesi uygulayarak idari bölgeler, bölge veya posta kodu.
  • Yer kimliklerini enlem ve boylama göre bulmak için tersine coğrafi kodlamayı kullanın koordinatlarını verebilir, hatta belirli bir konumdaki tüm bileşenlerin konum.

Aşağıdaki örnekte Coğrafi Kodlama API'sı:

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

Yer kimliklerini bulmak için tersine coğrafi kodlama özelliğini kullanabilirsiniz. Aşağıdaki coğrafi kodlama hizmeti işlevi örneği, belirtilen enlem ve boylam koordinatlarındaki tüm adres bileşenlerinin yer kimliklerini döndürür:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

Adres bileşenini almak için bileşen filtrelemeyle tersine coğrafi kodlama kullanma belirtilen konumda aşağıdaki türlerin biri veya daha fazlası için:

  • administrativeArea
  • country
  • locality
  • postalCode

Bir sonraki örnek işlev, Coğrafi Kodlama hizmetini kullanarak tüm adres bileşenlerini aynı zamanda almak için tersine coğrafi kodlamayla yalnızca locality türü için belirtilen konum:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY