Yeni Yerler API'ları Hakkında

Yeni Places API aşağıdaki API'leri içerir:

Bu belge, söz konusu yeni API'lere genel bakış içerir.

Yer Ayrıntıları API'sı

Yer kimliği, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz bir şekilde tanımlar. Yer kimliğiyle Yer Ayrıntıları (Yeni) isteği göndererek belirli bir kuruluş veya önemli yer hakkında ayrıntılı bilgi isteyebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi kapsamlı bilgiler döndürür.

Yer kimliğini pek çok şekilde edinebilirsiniz. Şunları kullanabilirsiniz:

Yer Fotoğrafı API'sı

Place Photo (Yeni) API, Google Rehber veritabanında depolanan milyonlarca fotoğrafa erişim sağlayarak uygulamanıza yüksek kaliteli fotoğraf içeriği eklemenize olanak tanır. Place Photo (New) API'yi kullanarak fotoğraflara erişebilir ve resmi, uygulamanız için optimum boyuta uyacak şekilde yeniden boyutlandırabilirsiniz.

Yer Fotoğrafı (Yeni) API'sine yapılan tüm istekler, döndürülecek fotoğrafı benzersiz şekilde tanımlayan bir fotoğraf kaynağı adı içermelidir. Fotoğraf kaynağının adını şunu kullanarak bulabilirsiniz:

Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakında Arama (Yeni) isteğindeki yanıta fotoğraf kaynağı adını eklemek için isteğin alan maskesine photos alanını dahil ettiğinizden emin olun.

Metin Arama ve Yakında Arama

Places API'si iki arama API'si içerir:

  • Metin Arama (Yeni)

    Bir yeri aramak için kullanılacak metin dizesini belirtmenizi sağlar. Örneğin: "Avustralya, Sidney'de Acılı Vejetaryen Yemekler" veya "Palo Alto, CA yakınlarındaki lezzetli deniz ürünleri restoranları".

    Fiyat seviyeleri, mevcut açılış durumu, puanlar veya belirli yer türleri gibi ayrıntıları belirterek aramayı hassaslaştırabilirsiniz. Ayrıca, sonuçları belirli bir konuma göre belirlemeyi veya aramayı belirli bir konumla sınırlandırmayı tercih edebilirsiniz.

  • Yakındakilerde Arama (Yeni)

    Yer türleri listesiyle birlikte aranacak bir bölge belirtmenizi sağlar. Bölgeyi, merkez noktasının enlem ve boylam koordinatları ve metre cinsinden yarıçapı ile tanımlanan bir daire olarak belirtin.

    Yerin özelliklerini tanımlayan bir veya daha fazla yer türü belirtin. Örneğin, belirtilen bölgedeki bir alışveriş merkezinde bulunan bir pizza restoranını aramak için "pizza_restaurant" ve "shopping_mall" ifadelerini belirtin.

İki arama arasındaki temel fark, Metin Arama'nın (Yeni) rastgele bir arama dizesi belirtmenize izin verirken, Yakındaki Arama (Yeni) arama için belirli bir alan gerektirmesidir.

Autocomplete API ve oturum jetonları

Autocomplete (New) API, HTTP isteğine yanıt olarak yer tahminleri ve sorgu tahminleri döndüren bir web hizmetidir. İstekte bir metin arama dizesi ve arama alanını kontrol eden coğrafi sınırlar belirtin.

Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını oturum olarak izleyen, kullanıcı tarafından oluşturulmuş dizelerdir. Otomatik Tamamlama (Yeni), bir kullanıcı otomatik tamamlama aramasının sorgu ve seçim aşamalarını faturalandırma amacıyla ayrı bir oturum halinde gruplandırmak için oturum jetonlarını kullanır.

Yeni alanlar, özellikler ve erişilebilirlik seçenekleri

Places API (Yeni), kullanıcılara bir yer hakkında daha fazla bilgi sağlamak için yeni alanlar, özellikler ve erişilebilirlik seçenekleri içerir. Bu yönler aşağıdaki bölümlerde açıklanmıştır.

Alanlar

Places API (Yeni) birkaç yeni alan içeriyor:

Alan Açıklama
regularSecondaryOpeningHours Belirli işlemlerin belirli saatlerini açıklar. İkincil çalışma saatleri, bir işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran ikincil saatleri olarak arabaya servis saatleri veya teslimat saatlerini belirtebilir.
paymentOptions Yerin kabul ettiği ödeme seçenekleri. Bir yerde birden fazla ödeme seçeneği kabul edilebilir. Ödeme seçeneği verileri mevcut değilse ödeme seçeneği alanı ayarlanmaz. Seçenekler arasında şunlar bulunur:
  • Kredi kartı
  • Banka kartı
  • Yalnızca nakit
  • NFC ödemesi
parkingOptions Yer tarafından sunulan otopark seçenekleri. Seçenekler arasında şunlar bulunur:
  • Ücretsiz park yerleri
  • Ücretli otoparklar
  • Cadde üzerinde ücretsiz park yeri
  • Vale park
  • Ücretsiz kapalı otopark
  • Ücretli kapalı otopark
subDestinations Belirli bir yerle ilgili benzersiz yerler. Örneğin, havaalanı terminalleri bir havaalanının alt varış noktaları olarak kabul edilir.
fuelOptions Bir benzin istasyonundaki yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir. Seçenekler şunlardır:
  • Dizel
  • Normal öncülüksüz
  • 89 Oktan
  • Premium
  • SP91
  • SP91, Ö10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • Metan
  • Biyodizel
  • Kamyon dizel
evChargeOptions Bu istasyondaki elektrikli araç (EV) şarj cihazlarının sayısı. Bazı EV şarj cihazlarının birden fazla konnektörü olsa da her şarj cihazı aynı anda yalnızca bir aracı şarj edebilir. Sonuç olarak bu alan, belirli bir zamanda mevcut EV şarj cihazlarının sayısını gösterir.
shortFormattedAddress Bir yere ait kısa, kullanıcılar tarafından okunabilir bir adres.
primaryType Belirtilen sonucun birincil türü. Örneğin, bir yer cafe veya airport olarak sınıflandırılabilir. Bir yerin yalnızca tek bir birincil türü olabilir. Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın.
primaryTypeDisplayName Birincil türün görünen adı (varsa istek diline göre yerelleştirilmiş). Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın.

Özellikler

Places API'si (Yeni) birkaç yeni özellik içeriyor:

Özellik Açıklama
outdoorSeating Mekanın açık havada oturma alanı vardır.
liveMusic Burada canlı müzik programı vardır.
menuForChildren Mekanda çocuk menüsü vardır.
servesCocktails Mekanda kokteyl servisi yapılır.
servesDessert Tesiste tatlı servisi vardır.
servesCoffee Burada kahve servisi vardır.
goodForChildren Burası çocuklar için iyi bir yer.
allowsDogs Burada köpeklere izin veriliyor.
restroom Yerde tuvalet var.
goodForGroups Yer, grupları barındırır.
goodForWatchingSports Burası spor müsabakaları izlemek için uygun.

Erişilebilirlik seçenekleri

Places API (Yeni) aşağıdaki erişilebilirlik seçeneği alanlarını içerir:

Alan Açıklama
wheelchairAccessibleParking Burada tekerlekli sandalyeye uygun park yeri bulunur.
wheelchairAccessibleEntrance Yerin tekerlekli sandalyeye uygun girişi vardır.
wheelchairAccessibleRestroom Burada tekerlekli sandalyeye uygun tuvalet var.
wheelchairAccessibleSeating Burada tekerlekli sandalyeye uygun oturma düzeni vardır.

Yeni Yerler API'lerine Geçin

Mevcut bir Places API müşterisiyseniz ve uygulamanızı yeni API'leri kullanacak şekilde taşımak istiyorsanız aşağıdaki taşıma belgelerine bakın: