Yer kimlikleri

Platform seçin: Android iOS JavaScript Web Hizmeti

Yer kimlikleri, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Yer kimlikleri aşağıdaki Haritalar API'lerine yapılan isteklerde kabul edilmektedir:

  • Geocoding API web hizmetinde bir Yer Kimliği için adres alma ve Coğrafi Kodlama Hizmeti, Maps JavaScript API.
  • Başlangıç, hedef ve ara ara noktaları belirtmek üzere Routes API ve Directions API'si web hizmeti ve Yol Tarifi Hizmeti, Maps JavaScript API.
  • Routes API'de kaynakları ve hedefleri belirterek Mesafe Matrisi API web hizmeti ve Mesafe Matrisi Hizmeti, Maps JavaScript API.
  • Places API web hizmetinde, Android için Yerler SDK'sı, iOS için Yerler SDK'sı ve Yerler Kitaplığı'nda Yer Ayrıntılarını alma.
  • Maps Embed API'de Yer Kimliği parametrelerini kullanma.
  • Haritalar URL'lerindeki arama sorguları alınıyor.
  • Roads API'de hız sınırları gösteriliyor.
  • Sınırlar için veriye dayalı stil oluşturma amacıyla sınır poligonlarını bulma ve stil özelliklerini ayarlama.

Belirli bir yerin kimliğini bulma

Belirli bir yerin yer kimliğini mi arıyorsunuz? Yer kimliğini kullanın bulmak için aşağıdaki bulucuyu kullanın:

Alternatif olarak göster Maps JavaScript API'deki koduyla birlikte yer kimliği bulucu belgelerinden faydalanabilirsiniz.

Genel Bakış

Yer kimliği, bir yeri benzersiz şekilde tanımlayan metinsel bir tanımlayıcıdır. İlgili içeriği oluşturmak için kullanılan tanımlayıcının uzunluğu değişebilir (Yer Kimlikleri için maksimum uzunluk yoktur). Örnekler:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

Yer kimlikleri, işletmeler, önemli noktalar, işletmeler ve diğer konumlar dahil olmak üzere kavşaklar bulunuyor. Aynı yer veya konumda, birden fazla yer kimliğine sahip. Yer kimlikleri zaman içinde değişebilir.

Aynı yer kimliğini Places API'de ve bir ve Google Maps Platform API'leri için geçerlidir. Örneğin, aşağıdakileri yapmak için aynı yer kimliğini kullanabilirsiniz: Şurada bir yere referans ver: Places API'yi Haritalar JavaScript API'si Geocoding API Haritalar Yerleştirme API'si ve Roads API hakkında daha fazla bilgi edinin.

Yer kimliğini kullanarak yer ayrıntılarını alın

Yer kimliklerini kullanmanın yaygın bir yolu, bir yeri aramaktır (Places API ile veya Yerler kitaplığı'ndaki izinleri içeriyorsa, yer ayrıntılarını almak için yer kimliği döndürdü. Yer kimliğini ve bu yeri kullanarak aynı yer ayrıntılarını daha sonra alabilirsiniz. Şu konu hakkında bilgi edinin: yer kimliklerini kaydetme bölümünü inceleyin.

Aşağıdaki örneklerde, Places API (Yeni) için simge URL'sinin nasıl isteneceği ve Yerler API'si.

Places API (Yeni)

Places API'yi kullanarak bir yer kimliği bulmak için bir Metin Arama (Yeni) isteğinde bulunabilirsiniz.

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

Yanıtın id alanında aşağıda gösterildiği gibi bir yer kimliği bulunur:

{
  "places": [
    {
      "id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0",
      "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Peace Harmony",
        "languageCode": "en"
      }
    },
  ...
}

Artık Arkadaş Bitkiler projesinin Yer Ayrıntıları (Yeni) istek URL'sine yer kimliğini ekleyerek isteğinizi belirtin:

https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY

Places API

Places API'yi kullanarak bir yer kimliği bulmak için bir Yer Arama isteği gönderin.

Aşağıdaki örnek, "restoran" türündeki yerler için bir arama isteğidir. Sidney, Avustralya'da bir noktanın 1.500 metre yarıçapında "deniz yolculuğu":

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

Yanıtın place_id alanında bir yer kimliği bulunur. Örneğin, aşağıdaki kod snippet'inde gösteriliyor:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

Artık size Yer Ayrıntıları isteği, place_id parametresine yer kimliğini ekleyerek:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY

Daha sonra kullanmak üzere yer kimliklerini kaydedin

Yer kimlikleri, Bölüm 3.2.3(b) Google Haritalar Platformu Hizmet Şartları'nı kabul etmiş olursunuz. Bu nedenle, yer kimliği değerlerini daha sonra kullanmak üzere pek de iyi olmadığını unutmayın.

Depolanan yer kimliklerini yenileme

12 aydan eski yer kimliklerini yenilemenizi öneririz. Siz alan kimlik bilgilerini ücretsiz olarak yenileyebilir. Yalnızca yer kimliğini belirten Yer Ayrıntıları isteği fields parametresindeki değer.

Places API (Yeni)

Örneğin, Yer Ayrıntıları (Yeni) seçeneğini kullanarak:

https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY

Places API

Örneğin, eski Yer Ayrıntıları API'sini kullanarak: 

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY

Bu çağrı, Yer Ayrıntısı Yeni (Yalnızca Kimlikler) veya Yer Ayrıntıları - Kimlik Yenileme SKU.

Bu istek, NOT_FOUND durumunu da döndürebilir girin. Stratejilerden biri, her yeri döndüren orijinal isteği saklamaktır Kimlik. Bir yer kimliği geçersiz hale gelirse, yeni bir alan adı almak için bu isteği sonuç. Bu sonuçlar orijinal yeri içerebilir veya içermeyebilir. Ancak bu istek ücretlidir.

Yer kimlikleri kullanılırken karşılaşılan hata kodları

INVALID_REQUEST durum kodu, yer kimliği geçerli değil. INVALID_REQUEST, yer kimliği kısaltılmış veya başka şekilde değiştirilmiştir ve artık doğru değildir.

NOT_FOUND durum kodu, belirtilen yer kimliğinin olduğunu gösterir geçerliliğini yitirmişti. Bir işletme kapanırsa veya bir yere taşınırsa yer kimliği geçersiz olabilir. bir konumdur. Yer kimlikleri, Google'daki büyük ölçekli güncellemeler nedeniyle değişebilir. Haritalar veritabanı. Bu gibi durumlarda, bir yer yeni bir yer kimliği alabilir ve eski konum kimliği Kimlik, NOT_FOUND yanıtı döndürür.

Özellikle, bazı yer kimlikleri bazen, NOT_FOUND yanıtı yoksa API, yanıt verelim. Bu yer kimliği türleri şunlardır:

  • Google Haritalar'da tam adres olarak bulunmayan açık adresler, ancak bir adres aralığından çıkarımda bulunur.
  • İsteğin aynı zamanda bir şehri veya şehir.
  • Kesişimler.
  • subpremise türünde adres bileşenine sahip yerler.

Bu kimlikler genellikle uzun bir dizedir (maksimum uzunluk yoktur.) bakın). Örneğin:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4