Giriş
Place Details (New),
Nearby Search (New) ve Text Search (New) API'lerinin yanıt biçimi, eski API'lerin biçiminden farklıdır. Temel fark, Changes to the response Place object (Yanıt Yer nesnesinde yapılan değişiklikler) bölümünde açıklandığı gibi, her yöntem tarafından döndürülen Place nesnesinin biçimindedir.
Ayrıca, yanıt nesnesinin en üst düzey alanları da her API için değişti. Şu konulara göz atın:
- Metin Arama yanıtı değişiklikleri
- Yakındaki Arama yanıtlarındaki değişiklikler
- Yer ayrıntıları yanıt değişiklikleri
Yanıt yer nesnesinde yapılan değişiklikler
Bu tabloda, Yer Ayrıntıları (Yeni), Yakınlardaki Arama (Yeni) ve Metin Arama (Yeni) yanıtlarındaki yeni
Place nesnesinde yapılan değişiklikler, eski
Place nesnesiyle karşılaştırılarak gösterilmektedir.
Yeni yanıt nesnesi, alan adları için camel-casing kullanır, yeni alanlar içerir ve eski alanlardan bazılarını yeniden adlandırır.
| Alan | Places API (Eski) nesnesi | Places API (Yeni) nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Yer mikro biçimi adresi | adr_address |
adrFormatAddress |
|
| İşletmenin durumu | business_status |
businessStatus |
|
| Önümüzdeki haftanın çalışma saatleri | current_opening_hours |
currentOpeningHours |
|
| İçerik özeti | editorial_summary |
editorialSummary |
|
| Biçimlendirilmiş adres | formatted_address |
formattedAddress |
|
| Ulusal telefon numarası | formatted_phone_number |
nationalPhoneNumber |
|
| Konum | geometry.location |
location |
|
| Görüntü alanı | geometry.viewport |
viewport |
|
| Yer ilişkilendirmeleri | html_attributions |
attributions |
Eski API'lerdeki yanıtın en üst düzey alanı |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor özelliğini kullanın. Daha fazla bilgi için Yer simgeleri bölümüne bakın. |
|
| Simge arka plan rengi | icon_background_color |
iconBackgroundColor |
|
| Simge maskesi URL'si | icon_mask_base_uri |
iconMaskBaseUri |
|
| Uluslararası telefon numarası | international_phone_number |
internationalPhoneNumber |
|
| Metin yer adı | name |
displayName |
Metin yer adı artık displayName.text olarak, language ise displayName.languageCode olarak erişilebilir. |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
photos biçimi yeni Place nesnesinde değişti. Daha fazla bilgi için Fotoğraf referanslarına geçiş başlıklı makaleyi inceleyin. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| Yorumlar | reviews |
reviews |
|
| Bugünden itibaren geçerli olmak üzere, istisnalar ve diğer tüm verilerle birlikte gelecek haftanın ikincil çalışma saatleri | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Yer türleri | types |
types |
|
| Yerin Google Haritalar URL'si | url |
googleMapsUri |
|
| Kullanıcı puanlarının sayısı | user_ratings_total |
userRatingCount |
|
| UTC farkı | utc_offset |
utcOffsetMinutes |
|
| Sokak adı ve şehir de dahil olmak üzere adresin kısa biçimi | vicinity |
shortFormattedAddress |
|
| Yerin web sitesi | website |
websiteUri |
|
| Tekerlekli sandalyeye uygunluk bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance artık accessibilityOptions.wheelchairAccessibleEntrance adresinde |
| Yer özellikleri | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Kaynak adı | places/PLACE_ID formundaki name alanı |
Eski API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName içinde yer alır. |
|
| Birincil yer türü | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştirin | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm verilerle birlikte düzenli haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Mekanın kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Park yeri seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Benzin istasyonundaki yakıt seçenekleri hakkında en son bilgiler | fuelOptions |
Yeni | |
| Bir yer için elektrikli araç şarjı bilgileri | evChargeOptions |
Yeni | |
| Yer özellikleri | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Yeni |
Metin Arama yanıt değişiklikleri
Aşağıdaki tabloda, Metin Arama (Eski) için yanıt nesnesinin ve Metin Arama (Yeni) için yanıt nesnesinin üst düzey alanlarındaki değişiklikler gösterilmektedir. Yeni API'de yanıttaki tek üst düzey alan places dizisidir.
| Alan | Metin Arama (Eski) | Metin Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için yeni Yer nesnesine taşındı place.attributions |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi. | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi. | |
| Bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yakında Arama yanıt değişiklikleri
Aşağıdaki tabloda, Yakınlarda Arama (Eski) için response
object
ve Yakınlarda Arama (Yeni) için response
object üst düzey alanlarındaki değişiklikler gösterilmektedir. Yeni API'de yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakında Arama (Eski) | Yakında Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için yeni Yer
nesnesine place.attributions olarak taşındı |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
Yeni Yer nesnesinin places dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi. | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi. | |
| Bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yer Ayrıntıları (Yeni) yanıt değişiklikleri
Aşağıdaki tabloda, Yer Ayrıntıları (Eski) için response
object ve Yer Ayrıntıları (Yeni) için response
object üst düzey alanlarındaki değişiklikler gösterilmektedir. Yeni API'de yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yer ayrıntıları (eski) | Yer Ayrıntıları (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Yeni Yer'e taşındı
Nesne attributions olarak |
|
| Yer Ayrıntıları (Yeni) | Eski Yer nesnesini içeren result |
Yeni Yer nesnesi | |
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi. | |
| Bilgi mesajları | info_messages |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi. |