Giriş
Yer Ayrıntıları (Yeni),
Yakındaki Yerlerde Arama (Yeni) ve Metin Arama (Yeni) API'lerinin yanıt biçimi, eski API'lerin biçiminden farklıdır. Temel fark, 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ındaki 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çim 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ıtta 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 başlıklı makaleyi inceleyin. |
|
| 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 önümüzdeki 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 responseobject ve Yer Ayrıntıları (Yeni) için responseobject ü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ı
attributions olarak yerleştirildi |
|
| 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. |