Method: places.get

Bir yerin ayrıntılarını, places/{placeId} biçimindeki bir dize olan kaynak adına göre alın.

HTTP isteği

GET https://places.googleapis.com/v1/{name=places/*}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Bir yerin places/{placeId} biçimindeki kaynak adı.

Sorgu parametreleri

Parametreler
languageCode

string

İsteğe bağlı. Yer ayrıntıları, varsa tercih edilen dilde gösterilir.

Desteklenen dillerin güncel listesi: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

İsteğe bağlı. İsteğin gönderildiği konumun Unicode ülke/bölge kodu (CLDR). Bu parametre, varsa bölgeye özgü yer adı gibi yer ayrıntılarını göstermek için kullanılır. Parametre, geçerli yasaya göre sonuçları etkileyebilir. Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.
sessionToken

string

İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda, URL ve dosya adı için güvenli bir base64 dizesi olmalıdır. Aksi takdirde INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcının sorgu yazmaya başlamasıyla başlar, bir yer seçmesi ve Yer Ayrıntıları veya Address Validation'a yönelik bir çağrı yapılmasıyla sona erer. Her oturumda birden fazla sorgu olabilir ve ardından bir Yer Ayrıntıları veya Address Validation isteği gönderilebilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton geçerliliğini kaybeder. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessionToken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Aşağıdaki yönergeleri uygulamanızı öneririz:

  • Tüm Yer Adı Otomatik Tamamlama çağrıları için oturum jetonlarını kullanın.
  • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanmanız önerilir.
  • Bir oturumdaki tüm Yer Adı Otomatik Tamamlama, Yer Ayrıntıları ve Address Validation istekleri için kullanılan kimlik bilgilerinin aynı Cloud Console projesine ait olduğundan emin olun.
  • Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Başarılıysa yanıt metni, Place öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform